내보내기(0) 인쇄
모두 확장
EN
이 콘텐츠는 한국어로 제공되지 않아 영어 버전으로 표시됩니다.

SHEnumValue function

Enumerates the values of the specified open registry key.

Syntax


LSTATUS SHEnumValue(
  _In_         HKEY hkey,
  _In_         DWORD dwIndex,
  LPTSTR pszValueName,
  _Inout_opt_  LPDWORD pcchValueName,
  _Out_opt_    LPDWORD pdwType,
  LPVOID pvData,
  _Inout_opt_  LPDWORD pcbData
);

Parameters

hkey [in]

Type: HKEY

A handle to the currently open key, or any of the following predefined values.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

dwIndex [in]

Type: DWORD

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

pszValueName

Type: LPTSTR

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

pcchValueName [in, out, optional]

Type: LPDWORD

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

pdwType [out, optional]

Type: LPDWORD

The 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

Type: LPVOID

The 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 [in, out, optional]

Type: LPDWORD

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

Return value

Type: LSTATUS

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 retrieve a textual description of the error.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 4.71 or later)

Unicode and ANSI names

SHEnumValueW (Unicode) and SHEnumValueA (ANSI)

 

 

커뮤니티 추가 항목

추가
Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft