RSC/MP Programming Manual

API Function Descriptions RscConnect [RSCCON]
RscConnect [RSCCON]
The RscConnect function establishes the connection between the workstation and the
TDP. If the function is successful, it places a connection handle in the variable pointed
to by the pulConnectionHandle parameter. This handle is used to reference the
connection in all subsequent requests destined for the TDP.
USHORT RscConnect
(ULONG ulOptionsHandle /* in */
,USHORT uWaitOption /* in */
,ULONG *pulConnectionHandle /* out */
);
ulOptionsHandle
The handle of an existing options structure created through the RscCreateOptions
function call. Placing RSC_DEFAULT_OPTIONS in this field indicates that the
default options should be used. See Appendix D, API Option Definitions, for
applicable options.
uWaitOption
The value of this parameter must be set to the RSC_CONNECT_WAITED
constant.
pulConnectionHandle
A pointer to the variable that receives the connection ha ndle.
Return Value
The return va lue is zero if the function is successful; otherwise, the function returns
one of these result va lues:
RSC_SUBSYSTEM_NOT_AVAILABLE
3
RSC_INI_FILE_NOT_FOUND
5
RSC_INVALID_OPTIONS_HANDLE
10
RSC_PC_HEAP_EXHAUSTED
22
RSC_INVALID_WAIT_OPTION
31
RSC_OPTIONS_AREA_CORRUPTED
34
RSC_TERMINAL_NOT_CONFIGURED
37
RSC_TERMINAL_NOT_STARTED
43
RSC_API_CS_MLREV_CONFLICT
97
RSC_API_TDP_MLREV_CONFLICT
98
RSC_MSG_PROTOCOL_VIOLATION
99
HP NonStop Remote Server Call (RSC/MP) Programming Manual — 522360-006
10 - 7