IStdSessionLogin::InitializeViaSessionName

The InitializeViaSessionName method initializes the client application's StdSessionLogin component for the login session to FileNet Workplace and instructs the component to create and use a separate, non-unified login for the client application. If you would prefer that the StdSessionLogin component share a single, unified login with all other FileNet Office Add-Ins, initialize the component using the InitializeUnifiedLogin method.

void spIStdSessionLogin->InitializeViaSessionName(_bstr_t bstrSessionName);

Parameters: bstrSessionName - [in] Required _bstr_t, which specifies the name of the session / client application that is initializing the StdSessionLogin component.

Results: If the InitializeViaSessionName method successfully initializes the StdSessionLogin component, the method returns an HRESULT value of S_OK; otherwise it returns E_INVALIDARG.

Sample: The following is a fragment from the complete example for the IStdSessionLogin interface.

   ...
   // Initialize the StdSessionLogin component to create
   // a separate, non-unified login for the client application
   // by specifying the session / client application name.
   std::cout << "Initializing the StdSessionLogin component to use NON-unified login..." << std::endl;
   _bstr_t sessionName(_T("WordPerfect"));
   spIStdSessionLogin->InitializeViaSessionName(sessionName);
   ...