열린 클러스터 데이터베이스 키의 값과 연결된 이름, 형식 및 데이터 구성 요소를 반환합니다.
구문
LONG ClusterRegQueryValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[out, optional] LPDWORD lpdwValueType,
[out, optional] LPBYTE lpData,
[in, out, optional] LPDWORD lpcbData
);
매개 변수
[in] hKey
쿼리할 클러스터 데이터베이스 키의 핸들입니다.
[in] lpszValueName
쿼리할 값의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
[out, optional] lpdwValueType
키의 값 형식에 대한 포인터입니다. 형식이 필요하지 않은 경우 이 매개 변수는 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 매개 변수가 가리키는 버퍼의 바이트 수에 대한 포인터입니다. 출력에서 호출자가 유효한 포인터를 전달하는 경우 lpbData 의 내용에 배치되는 값 데이터의 바이트 수에 대한 포인터입니다.
lpbData가 NULL인 경우에만 lpbData 매개 변수는 NULL일 수 있습니다.
반환 값
함수는 다음 값 중 하나를 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
작업이 완료되었습니다. |
|
lpbData가 가리키는 버퍼는 값에 대한 데이터를 저장할 만큼 크지 않습니다. ClusterRegQueryValue 는 lpbData의 콘텐츠에 필요한 크기를 저장합니다. |
설명
lpbData가 NULL인 경우 ClusterRegQueryValue 함수는 ERROR_SUCCESS 반환하고 값의 데이터 크기를 lpbData의 콘텐츠에 저장합니다. 이 정보를 사용하면 호출자가 데이터를 저장할 버퍼를 올바르게 할당할 수 있습니다.
lpdwValueType이 REG_SZ, REG_MULTI_SZ 또는 REG_EXPAND_SZ 설정된 경우 lpbData에는 NULL 종결자도 포함됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |