GetInitiateParameters Method
The GetInitiateParameters method uses the Application Known As Name (AKA Name) parameter to request Initiate parameters from a Name Server. A subsequent Connect method (with AKAName parameter omitted) uses these parameters to make a connection to a server installation and process that hosts the OpenROAD application image.
HRESULT GetInitiateParameters
(
[in] BSTR AKAName,
[in, optional] BSTR Location,
[in, optional] BSTR Routing
);
GetInitiateParameters is an optional method. If the Initiate parameters do not need to be inspected, method Connect should be used alone, passing the required AKAName as a parameter.
The Initiate parameters can be requested from the Name Server using the GetInitiateParameters method and inspected before invoking the subsequent Connect method. In this case, the AKAName parameter should not be passed to the Connect method.
This method uses the following parameters:
AKAName
(Required.) Contains the name of the Application Known As Name registered with Visual OSA
Location
Identifies the location where the OpenROAD Server is started. Contains the machine name (or DNS name or IP address) of the machine on which the Name Server is located. If no location is specified, the DCOM settings on the client machine are used to determine where to locate the Name Server.
Routing
Specifies a routing string. Specifying “unauthenticated” enables an explicitly unauthenticated connection to the Name Server. This overrides the default authentication level currently set for the client process.
Typically, the Connect method alone should be used to connect to the required server process.