Contents Index Topic Contents
	Previous Topic: SHOpenRegStream Next Topic: SHQueryValueEx

SHQueryInfoKey

DWORD SHQueryInfoKey(
    HKEY hkey,
    LPDWORD pcSubKeys,
    LPDWORD pcchMaxSubKeyLen,
    LPDWORD pcValues,
    LPDWORD pcchMaxValueNameLen
);

Retrieves information about a specified registry key.

• Returns ERROR_SUCCESS if successful, or a nonzero error code defined in Winerror.h otherwise. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a textual description of the error.

hkey

Handle to the currently open key, or any of the following predefined values:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_DYN_DATA (Windows 95 only)

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA (Windows NT only)

HKEY_USERS

pcSubKeys

Address of a DWORD that receives the number of subkeys under the specified key.

pcchMaxSubKeyLen

Address of a DWORD that receives the number of characters in the name of the subkey with the largest name.

pcValues

Address of a DWORD that receives the number of values under the specified key.

pcchMaxValueNameLen

Address of a DWORD that receives the number of characters in the name of the value with the largest name.

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.