REG_SET_VALUE Routine

Associates a value with a specified registry key by accessing the Windows registry routine RegSetValue.

Usage

Call "REG_SET_VALUE"
   USING OPEN-KEY-HANDLE, VALUE,
   GIVING STATUS-CODE

or

Call "REG_SET_VALUE"
   USING OPEN-KEY-HANDLE, VALUE, SUBKEY-NAME,
   GIVING STATUS-CODE

Parameters

OPEN-KEY-HANDLE Usage unsigned-long

Handle of a currently open key or one of the following predefined handles of keys that are always open (defined in acugui.def):

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

VALUE PIC X(n)

String containing the value to set for the specified key.

SUBKEY-NAME PIC X(n)

Optional parameter. Name of a subkey of OPEN-KEY-HANDLE with which to associate a value. If there is no existing subkey matching the name specified, REG_SET_VALUE will first create it. If SUBKEY-NAME is omitted or contains an empty string, the specified value will be associated with the key identified by OPEN-KEY-HANDLE.

STATUS-CODE Numeric data item.

Receives the return status of the call to Microsoft's "RegSetValue" function. A return status of zero indicates success; non-zero indicates that an error occurred.