클러스터 데이터베이스에서 이진 값을 반환합니다.
구문
DWORD ResUtilGetBinaryValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[out, optional] LPBYTE *ppbOutValue,
[out] LPDWORD pcbOutValueSize
);
매개 변수
[in] hkeyClusterKey
검색할 값의 위치를 식별하는 클러스터 데이터베이스의 키입니다.
[in] pszValueName
검색할 값의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
[out, optional] ppbOutValue
검색된 값에 대한 포인터의 주소입니다.
[out] pcbOutValueSize
ppbOutValue가 가리키는 버퍼의 크기(바이트)가 반환되는 DWORD에 대한 포인터입니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 오류 코드입니다.
| 반환 코드 | 설명 |
|---|---|
|
값에 대한 메모리를 할당하는 동안 오류가 발생했습니다. |
설명
ResUtilGetBinaryValue 유틸리티 함수는 값에 필요한 메모리를 할당한 다음 Cluster API 함수 ClusterRegQueryValue를 호출합니다. 할당된 메모리를 완료하면 LocalFree 함수를 호출하여 해제해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |