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 입니다. 형식 코드는 다음 값 중 하나일 수 있습니다.
모든 형태의 이진 데이터입니다.
32비트 숫자입니다.
big-endian 형식으로 저장된 32비트 숫자입니다.
환경 변수에 대한 확장되지 않은 참조(예: "%PATH%")를 포함하는 null로 종료된 유니코드 문자열입니다.
빈 문자열(\0)에 의해 종료되는 null로 끝나는 문자열 시퀀스입니다.
다음은 이에 대한 예입니다.
String1\0String2\0String3\0LastString\0\0
첫 번째 \0은 첫 번째 문자열을 종료하고, 마지막 \0의 두 번째 문자열은 마지막 문자열을 종료하고, 마지막 \0은 시퀀스를 종료합니다. 최종 종결자는 문자열의 길이로 계산되어야 합니다.
정의된 값 형식이 없습니다.
64비트 숫자입니다.
null로 끝나는 유니코드 문자열입니다.
[out, optional] lpData
값 항목의 데이터에 대한 포인터입니다. 데이터가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.
[in, out, optional] lpcbData
입력 시 lpbData 매개 변수가 가리키는 버퍼의 바이트 수에 대한 포인터입니다. 출력에서 작업으로 인한 바이트 수에 대한 포인터입니다. 이 매개 변수는 lpbData가 NULL인 경우에만 NULL일 수 있습니다.
함수는 다음 값 중 하나를 반환합니다.
반환 코드/값 | 설명 |
---|---|
|
작업이 완료되었습니다. |
|
반환할 값이 더 이상 없습니다. |
|
출력 버퍼(lpszValueName 또는 lpbData) 중 하나가 너무 작아 결과 데이터를 보유할 수 없습니다. lpcchValueName 및 lpbData 매개 변수는 필요한 크기를 나타냅니다(lpcchValueName은 문자 수에 종결 NULL을 포함하지 않음). |
작업이 실패했습니다. |
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
대상 플랫폼 | Windows |
헤더 | clusapi.h |
라이브러리 | ClusAPI.lib |
DLL | ClusAPI.dll |