Ice 3.8
Slice API Reference
Loading...
Searching...
No Matches

◆ createSession()

["amd"]
Session * createSession ( string userId,
string password ) throws PermissionDeniedException, CannotCreateSessionException

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

If a SessionManager is configured, a proxy to a Session 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
userIdThe user ID.
passwordThe password.
Returns
A proxy for the newly created session, or null if no SessionManager is configured.
Exceptions
PermissionDeniedExceptionThrown when an authentication or authorization failure occurs.
CannotCreateSessionExceptionThrown when the session cannot be created.
See also
Session
SessionManager
PermissionsVerifier