Callback for a Requestor when a requested session request is ready.
When successful, the session parameter is the new DOFObject for the session. This is only maintained for the duration of the callback itself, so if needed after the callback is finished, it must be copied (via DOFObject_Copy) and later freed by the application (via DOFObject_Destroy).
This callback may be NULL to ignore notification of the available session object.
- Parameters
-
| self | The callback object. This will never be NULL. |
| operation | The Session Operation. This will never be NULL. |
| providerInfo | The DOFProviderInfo associated with the session or exception. This will never be NULL. |
| session | The result of the Session request. If exception is non-NULL, this must be ignored and may be NULL. Otherwise, it will be a valid DOFObject that may be used by the application within the context of this callback. If the application needs to keep this DOFObject beyond the scope of this callback, it must be copied via DOFObject_Copy and therefore freed when no longer needed. |
| except | An exception, if any. If not NULL, this indicates the error that occurred. |
