RSC/MP Programming Manual

API Function Descriptions RscSetOption [RSCOS]
RscSetOption [RSCOS]
The RscSetOption function sets a selected option identified by pcOptionSelector in the
options structure identified by ulOptionsHandle to the value in ulOptionValue (if the
option type is an integer) or referenced by pcOptionString (if the option type is a string).
See Appendix D, API Option Definitions, for a list of options and their meanings.
USHORT RscSetOption
(ULONG ulOptionsHandle /* in */
,CHAR *pcOptionSelector /* in */
,CHAR *pcOptionString /* in */
,SHORT nOptionValue /* in */
);
ulOptionsHandle
The handle of an existing options handle created through the RscCreateOptions
function call.
pcOptionSelector
A pointer to the buffer holding the options selector text. This parameter should
point to a character string no longer than 32 bytes (including the NULL or blank
terminator).
pcOptionString
A pointer to the character buffer containing the option string . If the type of the
option is an integer, this field is ignored. The length of the buffer pointed to by
pcOptionString depends on the option selected. The length of the string is usually
36 bytes or less (including the NULL terminator or blank padding).
nOptionValue
The option value of an integer option. If the type of the option is a string, this field is
ignored.
Return Value
The return va lue is zero if the function is successful; otherwise, the function returns
one of these result va lues:
RSC_INI_FILE_NOT_FOUND
5
RSC_INVALID_OPTIONS_HANDLE
10
RSC_INVALID_OPTION_SELECTOR
11
RSC_PC_HEAP_EXHAUSTED
22
RSC_OPTIONS_AREA_CORRUPTED
34
HP NonStop Remote Server Call (RSC/MP) Programming Manual — 522360-006
10 - 31