Opens a specified registry key.

bool AIT_RegOpenKey(
  integer nHKeyHandle,       // Key handle
  string strRegKeyName,      // Name of a key to be opened
  integer nOutputHkeyHandle  // Output key handle
);

nHKeyHandle (input)

Specify a handle to an already opened registry key, or one of the following values.

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

strRegKeyName (input)

Specify a sub-key name for a registry to be opened.

nOutputHkeyHandle (output)

Specify a variable to receive a handle to a registry key. When the function returns, the variable stores the handle.

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError may return.

Extended error number	Error code
2	ERROR_FILE_NOT_FOUND
6	ERROR_INVALID_HANDLE
87	ERROR_INVALID_PARAMETER
1009	ERROR_BADDB
1010	ERROR_BADKEY
1011	ERROR_CANTOPEN
1015	ERROR_REGISTRY_CORRUPT
1016	ERROR_REGISTRY_IO_FAILED
1018	ERROR_KEY_DELETED
1019	ERROR_NO_LOG_SPACE

• Before termination, call AIT_RegCloseKey to close nOutputHkeyHandle.
• If you attempt to open a registry key for which you do not have write permission, the registry key opens in the read-only mode.