ContentsIndexPreviousNext

REG_DELETE_VALUE Routine

Deletes a named value from a specified registry key.

Usage

Call "REG_DELETE_VALUE"
    USING OPEN-KEY-HANDLE, VALUE-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-NAME PIC X(n)

Name of the value to delete. If NULL or an empty string, the value set by REG_SET_VALUE will be deleted.

STATUS-CODE Numeric data item.

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

Comments

The key identified by OPEN-KEY-HANDLE must have been opened with KEY_SET_VALUE access (KEY_WRITE access includes KEY_SET_VALUE access).