Contents Index Topic Contents
	Previous Topic: SHDeleteValue Next Topic: SHEnumValue

SHEnumKeyEx

DWORD SHEnumKeyEx(
    HKEY hkey,
    DWORD dwIndex,
    LPTSTR pszName,
    LPDWORD pcchName
    );

Enumerates the subkeys of the specified open 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

dwIndex

Index of the subkey to retrieve. This parameter should be zero for the first call and incremented for subsequent calls.

pszName

Address of a character buffer that receives the enumerated key name.

pcchName

Address of a DWORD that, on entry, contains the size of the buffer at pszName. On exit, this contains the number of characters that were copied to pszName.

---

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