Connect Method
The Connect method uses the Application Known As Name (AKA Name) parameter to request Initiate parameters from a Name Server. It then uses these parameters to make a connection to a server installation and process that hosts the OpenROAD application image.
HRESULT Connect
(
[in, optional] BSTR AKAName,
[in, optional] BSTR Location,
[in, optional] BSTR Routing
);
A Connect must be done once—and only once—prior to using the CallProc or Call4GL methods.
If required, the Initiate parameters can be requested from the Name Server using the GetInitiateParameters method and inspected before invoking the Connect method. In this case, the AKAName parameter should not be passed to the Connect method.
This method uses the following parameters:
AKAName
Contains the name of the Application Known As Name registered with Visual OSA. It is required when it is not preceded by a call to method GetInitiateParameters.
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 should be used to connect to the required server process. This makes a connection using the Name Server, which is configured using Visual OSA. Alternatively, the Initiate method can be used to bypass the Name Server.