createSessionAsync() [1/2]

std::future< std::optional< SessionPrx > > Glacier2::RouterPrx::createSessionAsync ( std::string_view userId, std::string_view password, const Ice::Context & context = Ice::noExplicitContext ) const

nodiscard

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.
context	The request context.

Returns

A future that becomes available when the invocation completes. This future holds:

• A proxy for the newly created session, or null if no Glacier2::SessionManagerPrx is configured.

See also

Session

SessionManager

PermissionsVerifier