ReturnURL Event
Fires when the user is redirected to the embedded web server.
Syntax
ANSI (Cross Platform) virtual int FireReturnURL(OAuthReturnURLEventParams *e);
typedef struct {
const char *URLPath;
const char *QueryString;
char *ResponseHeaders;
char *ResponseBody; int reserved; } OAuthReturnURLEventParams; Unicode (Windows) virtual INT FireReturnURL(OAuthReturnURLEventParams *e);
typedef struct {
LPCWSTR URLPath;
LPCWSTR QueryString;
LPWSTR ResponseHeaders;
LPWSTR ResponseBody; INT reserved; } OAuthReturnURLEventParams;
- (void)onReturnURL:(NSString*)URLPath :(NSString*)queryString :(NSString**)responseHeaders :(NSString**)responseBody;
#define EID_OAUTH_RETURNURL 10 virtual INT CLOUDMAIL_CALL FireReturnURL(LPSTR &lpszURLPath, LPSTR &lpszQueryString, LPSTR &lpszResponseHeaders, LPSTR &lpszResponseBody);
Remarks
When ClientProfile is set to cfApplication and the embedded web server is used (default), this event will fire when the user is redirected from authorization server back to the local embedded web server. The event provides an opportunity to set the ResponseHeaders and ResponseBody and provide a custom response that the user will see in their browser.
URLPath and QueryString are informational parameters that show the values sent by the authorization server.