REG_OPEN_KEY_EX, DISPLAY_REG_OPEN_KEY_EX

The REG_OPEN_KEY_EX library routine opens the specified registry key. Note that key names are not case sensitive.

To perform this action on the Windows client machine in an Application Server architecture, use DISPLAY_REG_OPEN_KEY_EX instead of REG_OPEN_KEY_EX.

Syntax:

CALL "REG_OPEN_KEY_EX" USING openKey                                subKey                                sam                               resultKey                        GIVING returnCode

Parameters:

openKey	USAGE UNSIGNED-LONG	Specifies the handle to an open registry key. The calling process must have KEY_CREATE_SUB_KEY access to the key.   This handle is returned by the REG_CREATE_KEY, REG_CREATE_KEY_EX, REG_OPEN_KEY or REG_OPEN_KEY_EX library routine, or it can be one of the following predefined keys, defined in isreg.def:   HKEY_CLASSES_ROOT HKEY_CURRENT_CONFIG HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS HKEY_DYN_DATA
subKey	PIC X(n)	Specifies the name of the registry subkey to be opened.   Key names are not case sensitive.   If this parameter is NULL or an empty string, the function will open a new handle to the key identified by the openKey parameter.
sam	USAGE UNSIGNED-LONG	It specifies a mask that specifies the desired access rights to the key. The function fails if the security descriptor of the key does not permit the requested access for the calling process. It must be the combination of the following values, defined in isreg.def:
		KEY_ALL_ACCESS	Combines the STANDARD_RIGHTS_REQUIRED, KEY_QUERY_VALUE, KEY_SET_VALUE, KEY_CREATE_SUB_KEY, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY, and KEY_CREATE_LINK access rights.
		KEY_CREATE_LINK	Reserved for system use.
		KEY_CREATE_SUB_KEY	Required to create a subkey of a registry key.
		KEY_ENUMERATE_SUB_KEYS	Required to enumerate the subkeys of a registry key.
		KEY_NOTIFY	Required to request change notifications for a registry key or for subkeys of a registry key.
		KEY_QUERY_VALUE	Required to query the values of a registry key.
		KEY_READ	Combines the STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, and KEY_NOTIFY values.
		KEY_SET_VALUE	Required to create, delete, or set a registry value.
		KEY_WRITE	Combines the STANDARD_RIGHTS_WRITE, KEY_SET_VALUE, and KEY_CREATE_SUB_KEY access rights.
resultKey	USAGE UNSIGNED-LONG	It receives a handle to the opened or created key. If the key is not one of the predefined registry keys, call the REG_CLOSE_KEY library routine after you have finished using the handle.

Return code:

returnCode can be any signed numeric data item and provides additional information:

-1	Invalid or missing parameters, or not running on Windows
0	Operation successful.
Non zero	Operation failed. Click here for a list of error codes.

Examples:

Example - Open a key

working-storage section. copy "isreg.def". 01  open-key-handle         usage unsigned-long. 01  subkey-handle           usage unsigned-long. 77  status-code             pic 9(3). 01  key-sam                 usage unsigned-long. ... procedure division. ... open-key.    move hkey_local_machine to open-key-handle    move KEY_ALL_ACCESS to key-sam    call "reg_open_key_ex"  using open-key-handle                                  "SOFTWARE"                                  key-sam                                  subkey-handle                           giving status-code.