Feedback

  • Contents
 

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.