Contents Index Topic Contents
	Previous Topic: SHRegEnumUSKey Next Topic: SHRegGetUSValue

SHRegEnumUSValue

DWORD SHRegEnumUSValue(
    HUSKEY hUSkey,
    DWORD dwIndex,
    LPTSTR pszValueName,
    LPDWORD pcchValueNameLen,
    LPDWORD pdwType,
    LPVOID pvData,
    LPDWORD pcbData,
    SHREGENUM_FLAGS enumRegFlags
    );

Enumerates the values of the specified user-specific 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.

hUSKey

Handle to the currently open user-specific key.

dwIndex

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

pszValueName

Address of a character buffer that receives the enumerated value name. The size of this buffer is specified in pcchValueName.

pcchValueNameLen

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

pdwType

Address of a DWORD that receives the data type of the value. These are the same values as those described under the lpType parameter of RegEnumValue.

pvData

Address of a buffer that receives the data for the value entry. The size of this buffer is specified in pcbData. This parameter can be NULL if the data is not required.

pcbData

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

enumRegFlags

One of the SHREGENUM_FLAGS that specifies the base key in which the enumeration should take place.

---

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