RSC/MP 7.2 Programming Manual

API Function Descriptions

HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004

10-31

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.

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 value is zero if the function is successful; otherwise, the function returns

one of these result values:

USHORT RscSetOption

(ULONG ulOptionsHandle /* in */

,CHAR *pcOptionSelector /* in */

,CHAR *pcOptionString /* in */

,SHORT nOptionValue /* in */

);

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