영어로 읽기

다음을 통해 공유


ClusterRegEnumValue 함수(clusapi.h)

열린 클러스터 데이터베이스 키의 값을 열거합니다.

구문

DWORD ClusterRegEnumValue(
  [in]                HKEY    hKey,
  [in]                DWORD   dwIndex,
  [out]               LPWSTR  lpszValueName,
  [in, out]           LPDWORD lpcchValueName,
  [out, optional]     LPDWORD lpdwType,
  [out, optional]     LPBYTE  lpData,
  [in, out, optional] LPDWORD lpcbData
);

매개 변수

[in] hKey

열거할 클러스터 데이터베이스 키의 핸들입니다.

[in] dwIndex

열거할 다음 값을 식별하는 데 사용되는 인덱스입니다. 이 매개 변수는 ClusterRegEnumValue 에 대한 첫 번째 호출에 대해 0이어야 하고 후속 호출에 대해 증가해야 합니다.

값은 정렬되지 않으므로 새 값에는 임의 인덱스가 있습니다. 즉 , ClusterRegEnumValue 는 임의의 순서로 값을 반환할 수 있습니다.

[out] lpszValueName

반환된 값의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in, out] lpcchValueName

문자 수로 lpszValueName 버퍼의 크기에 대한 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.

[out, optional] lpdwType

값 항목의 형식 코드에 대한 포인터이거나 형식 코드가 필요하지 않은 경우 NULL 입니다. 형식 코드는 다음 값 중 하나일 수 있습니다.

REG_BINARY (3)

모든 형태의 이진 데이터입니다.

REG_DWORD (4)

32비트 숫자입니다.

REG_DWORD_BIG_ENDIAN (5)

big-endian 형식으로 저장된 32비트 숫자입니다.

REG_EXPAND_SZ (2)

환경 변수에 대한 확장되지 않은 참조(예: "%PATH%")를 포함하는 null로 종료된 유니코드 문자열입니다.

REG_MULTI_SZ (6)

빈 문자열(\0)에 의해 종료되는 null로 끝나는 문자열 시퀀스입니다.

다음은 이에 대한 예입니다.

String1\0String2\0String3\0LastString\0\0

첫 번째 \0은 첫 번째 문자열을 종료하고, 마지막 \0의 두 번째 문자열은 마지막 문자열을 종료하고, 마지막 \0은 시퀀스를 종료합니다. 최종 종결자는 문자열의 길이로 계산되어야 합니다.

REG_NONE(0)

정의된 값 형식이 없습니다.

REG_QWORD (11)

64비트 숫자입니다.

REG_SZ (1)

null로 끝나는 유니코드 문자열입니다.

[out, optional] lpData

값 항목의 데이터에 대한 포인터입니다. 데이터가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[in, out, optional] lpcbData

입력 시 lpbData 매개 변수가 가리키는 버퍼의 바이트 수에 대한 포인터입니다. 출력에서 작업으로 인한 바이트 수에 대한 포인터입니다. 이 매개 변수는 lpbDataNULL인 경우에만 NULL일 수 있습니다.

반환 값

함수는 다음 값 중 하나를 반환합니다.

반환 코드/값 설명
ERROR_SUCCESS
0(0x0)
작업이 완료되었습니다.
ERROR_NO_MORE_ITEMS
259(0x103)
반환할 값이 더 이상 없습니다.
ERROR_MORE_DATA
234(0xEA)
출력 버퍼(lpszValueName 또는 lpbData) 중 하나가 너무 작아 결과 데이터를 보유할 수 없습니다. lpcchValueNamelpbData 매개 변수는 필요한 크기를 나타냅니다(lpcchValueName은 문자 수에 종결 NULL을 포함하지 않음).
시스템 오류 코드
작업이 실패했습니다.

요구 사항

   
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
대상 플랫폼 Windows
헤더 clusapi.h
라이브러리 ClusAPI.lib
DLL ClusAPI.dll

추가 정보

ClusterRegOpenKey