createSessionAsync()

virtual void Glacier2::AsyncRouter::createSessionAsync ( std::string userId, std::string password, std::function< void(const std::optional< SessionPrx > &returnValue)> response, std::function< void(std::exception_ptr)> exception, const Ice::Current & current )

pure virtual

Creates a session for the client (caller) with the router.

If a Glacier2::SessionManagerPrx is configured, a proxy to a Glacier2::SessionPrx object is returned to the client. Otherwise, null is returned and only an internal session (i.e., not visible to the client) is created. If a non-null session proxy is returned, it must be configured to route through the router that created it. This occurs automatically when the router is configured as the client's default router at the time the session proxy is created in the client application; otherwise, the client must configure the session proxy explicitly.

Parameters

userId	The user ID.
password	The password.
response	The response callback. It accepts: A proxy for the newly created session, or null if no Glacier2::SessionManagerPrx is configured.
exception	The exception callback.
current	The Current object of the incoming request.

Exceptions

Glacier2::CannotCreateSessionException	Thrown when the session cannot be created.
Glacier2::PermissionDeniedException	Thrown when an authentication or authorization failure occurs.

See also

Glacier2::SessionPrx

Glacier2::SessionManagerPrx

Glacier2::PermissionsVerifierPrx