ReturnURL Event

Fires when the user is redirected to the embedded web server.

Syntax

class OpenIDReturnURLEventParams {
public:
  const QString &URLPath();
  const QString &QueryString();
  const QString &State();
  const QString &ResponseHeaders();
  void SetResponseHeaders(const QString &qsResponseHeaders);
  const QString &ResponseBody();
  void SetResponseBody(const QString &qsResponseBody);
  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void ReturnURL(OpenIDReturnURLEventParams *e);

// Or, subclass OpenID and override this emitter function.
virtual int FireReturnURL(OpenIDReturnURLEventParams *e) {...}

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.

State holds the value of the state parameter that was originally sent with the authorization request. This may be used to maintain state between the request and response. See State for more details.