IBaseServerURL Interface

The BaseServerURL component is used to encapsulate information about the Application Engine for use by the ISilentSessionLogin interface. When the ISilentSessionLogin::InitializeWithCredentials method is used to initialize the SilentSessionLogin component, a pointer to an IBaseServerURL interface is provided which specifies the name of the Application Engine server, the port number, the client application, as well as the security of HTTP during the session.

COM Class ID

coclass BaseServerURL {
[default] interface IBaseServerURL;
};

Reference

DLL FnAppIntSession.dll
See Also ISilentSessionLogin Interface

Methods

The IBaseServerURL interface defines one method:

Method Description
Initialize

Initializes the BaseServerURL component for use by the client application's SilentSessionLogin component when establishing a login session to FileNet Workplace. The IBaseServerURL interface pointer provides information about the Application Engine, including the server name, port number, client application, and the security of HTTP during the session.

Example

The following is a fragment from the complete example for the ISilentSessionLogin interface, which utilizes a BaseServerURL component.

// Instantiate a BaseServerUrl Component
IBaseServerUrlPtr spIBaseServerURL;
HRESULT hResult = spIBaseServerURL.CreateInstance(__uuidof(BaseServerUrl));
if (FAILED(hResult)) { std::cout << "Could not create the BaseServerURL component." << std::endl; _ASSERTE(0); }
try {
// Initialize the BaseServerURL // with the Application Engine server name, port number, // client application name, and indicate if secure HTTP.
_bstr_t serverName(_T("eraser"));
_bstr_t portNumber(_T("8080"));
_bstr_t applicationName(_T("Workplace"));
VARIANT_BOOL bIsSecure = VARIANT_FALSE; std::cout << "Initializing the BaseServerURL component..." << std::endl;
spIBaseServerURL->Initialize(serverName, portNumber, applicationName, bIsSecure);
... } catch( ... ) { }
// Instantiate the SilentSessionLogin component ISilentSessionLoginPtr spISilentSessionLogin; HRESULT hResult = spISilentSessionLogin.CreateInstance(__uuidof(SilentSessionLogin)); if (FAILED(hResult)) { std::cout << "Could not create the SilentSessionLogin component." << std::endl; _ASSERTE(0); } try {
// Initialize the SilentSessionLogin component // with the user name and password login credentials // and the pointer to thee BaseServerURL component _bstr_t userName(_T("John Doe")); _bstr_t userPassword(_T("guest")); std::cout << "Initializing the SilentSessionLogin component..." << std::endl; spISilentSessionLogin->InitializeWithCredentials(userName, userPassword, spIBaseServerURL); ... } catch( ... ) { } ...