ISessionLogin Interface

CAUTION Customers should only use the IStdSessionLogin interface in new development, as well as replace existing implementations of the ISessionLogin interface with IStdSessionLogin or ISilentSessionLogin (to maintain session information without presenting a Login dialog to the user). The following information describes the interface as it was defined in FileNet P8 3.0.0 and is provided for informational purposes only. FileNet does not support development with the ISessionLogin interface in FileNet P8 3.5.0 or later.

The StdSessionLogin component maintains vital state information required for establishing a login session with FileNet Workplace, such as the Workplace Server URL, user credentials and the login tokens used to authenticate, establish and maintain a "session" with a Workplace Server. This component automatically handles requests for new tokens as they expire, including prompting the user with a Login dialog whenever necessary.

The client application must instantiate the StdSessionLogin component and initialize it with the client application name and unique application ID using the ISessionLogin interface. However, the client never directly invokes a login or logout operation through the ISessionLogin interface. Instead, the client passes the ISessionLogin interface pointer to the IAppIntSession::Initialize method of the AppIntSession component, which will cause the login and logout operations to be invoked as they are required during command execution. As a result, when a user initially logs into FileNet Workplace, the user is prompted with a Login dialog to supply Workplace Server URL information (which is automatically persisted for that user), as well as their username and password.

COM Class ID

coclass StdSessionLogin {
[default] interface ISessionLogin;
};

Reference

DLL FnAppIntSessionLogin.dll
See Also IStdSessionLogin, ISilentSessionLogin and IAppIntSession Interfaces

Methods

The ISessionLogin interface defines one method:

Method Description
Initialize This method is deprecated in FileNet P8 3.5.0 and later. Customers should use the InitializeUnifiedLogin or InitializeViaSessionName methods of the IStdSessionLogin interface instead.

Example

For a demonstration of how to use the IStdSessionLogin interface in FileNet P8 3.5.0 or later, see these examples.