_RegOpenKey

include vmm.h

LONG _RegOpenKey(HKEY hkey, LPTSTR lpszSubKey, PHKEY phkResult)

Opens the specified key. Caller should use RegCloseKey to close the returned key. See the documentation for the Win32 function of the same name for additional information.

Returns ERROR_SUCCESS if the function succeeds. Otherwise, an error code is returned, possibly one of the following:

ERROR_KEY_DELETED

ERROR_BADKEY

ERROR_FILE_NOT_FOUND

ERROR_OUTOFMEMORY

ERROR_REGISTRY_IO_FAILED

ERROR_REGISTRY_CORRUPT

ERROR_BADDB

hkey

Handle of an open key or one of the predefined keys:

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

HKEY_CURRENT_CONFIG

HKEY_DYN_DATA

lpszSubKey

Address of a null-terminated string containing the name of the key to open.

phkResult

Address of variable that receives handle of opened key.

The key opened by this service is a subkey of the key which hkey identifies.

If lpszSubKey is NULL or a pointer to an empty string, the service returns hkey.

Of the predefined key values, only HKEY_LOCAL_MACHINE and HKEY_DYN_DATA are available to VxDs during initialization time. The entire registry space can only be accessed after VxD initialization is complete.

_RegOpenKey

See Also