- Contents
SOAP Notifier COM API Developer's Guide
ISOAPNotifierTransport::Connect Method
Synopsis
Connects the transport to the Notifier server.
Function Prototype
HRESULT Connect(
[in,optional] VARIANT vtServer,
[in,optional] VARIANT vtApplicationId,
[in,optional] VARIANT vtUserId,
[in,optional] VARIANT vtPassword,
[in,optional] VARIANT vtClientName,
[in,optional] VARIANT vtFlags
);
C/C++ Syntax
HRESULT Connect(VARIANT vtServer, VARIANT vtApplicationId, VARIANT vtUserId, VARIANT vtPassword, VARIANT vtClientName, VARIANT vtFlags);
Parameters
vtServer
This optional input parameter is a VARIANT containing the Name of the Notifier server . If you do not specify a server name, the name stored in the registry of the localhost is used by default.
vtApplicationId
vtApplicationId is an optional input parameter of type VARIANT. It can contain the Name of the application establishing the connection.
vtUserId
vtUserId is an optional input parameter of type VARIANT. It can contain the Username for server login. The default value is an empty string.
vtPassword
vtPassword is an optional input parameter of type VARIANT. It can contain the Password for server login. The default value is an empty string.
vtClientName
vtClientName is an optional input parameter of type VARIANT. It can contain the Name of the SOAP client that will be sent with the SOAP request for debugging purposes. If you do not specify a value, it uses the value specified for vtApplicationId. If vtApplicationId is empty, the module name is used instead.
vtFlags
These optional connect flags are masked using any combination of the following:
Flag |
Description |
connectFlag_Default (0) |
Default setting. |
connectFlag_PromptOnFailure (1) |
Pop dialog when login fails. |
connectFlag_ForcePrompt (2) |
Always pop a login dialog. |
connectFlag_TryBackupFirst (4) |
Attempt to connect to backup Notifier server first. |
connectFlag_DontTryBackup (8) |
Connect to server only and not to its backup. |