RSC/MP Programming Manual

API Function Descriptions RscLoadOptions [RSCOL]
RscLoadOptions [RSCOL]
RscLoadOptionsEx
The RscLoadOptions and RscLoadOptionsEx functions set options in an options
structure with the values contained in an options definition file (such as RSC.INI). See
Appendix D, API Option Definitions for a list of options and their meanings.
USHORT RscLoadOptions
(ULONG ulOptionsHandle /* in */
,CHAR *pcFileName /* in */
,CHAR *pcSection /* in */
);
ulOptionsHandle
The handle of an existing options handle created through the RscCreateOptions
function call.
pcFileName
A pointer to a string containing the name of an options definition file. The length of
the character string pointed to by pcFileName is limited to 256 characters,
including the terminator.
If pcFileName is not fully qualified, the function uses the search order specified for
loading Default Options, see Using Default Options on page 3-4.
RscLoadOptions: both the NULL character and the space character are treated
as string terminators. Do not include embedded spaces in this parameter because
the first space found will be treated as a terminator. This treatment of the space
character is required to provide COBOL compatibility.
RscLoadOptionsEx: only the NULL character is treated as a string terminator;
embedded spaces are treated as spaces. This function is not COBOL compatible.
pcSection
A pointer to a string containing the section name to load. If NULL, the default
section (RSC) is loaded if the RSC section exists; otherwise, the NULL section is
loaded. Do not include the brackets ―[ ]‖ in the string containing the section name.
This parameter should point to a character string no longer than 32 bytes
(including the NULL terminator or blank padding).
HP NonStop Remote Server Call (RSC/MP) Programming Manual — 522360-006
10 - 19