다음을 통해 공유


ResUtilGetSzValue 함수(resapi.h)

클러스터 데이터베이스에서 문자열 값을 반환합니다.

구문

LPWSTR ResUtilGetSzValue(
  [in] HKEY    hkeyClusterKey,
  [in] LPCWSTR pszValueName
);

매개 변수

[in] hkeyClusterKey

클러스터 데이터베이스에서 값의 위치를 식별하는 키입니다.

[in] pszValueName

검색할 값의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.

반환 값

작업이 성공하면 함수는 문자열 값이 포함된 버퍼에 대한 포인터를 반환합니다.

작업이 실패하면 함수는 NULL을 반환합니다. 자세한 내용은 GetLastError 함수를 호출합니다.

설명

ResUtilGetSzValue 유틸리티 함수는 Cluster API 함수 ClusterRegQueryValue를 호출하여 클러스터 데이터베이스에 액세스하기 전에 문자열 매개 변수 값에 필요한 메모리를 할당합니다. 이 메모리를 마치면 LocalFree 함수를 호출하여 해제해야 합니다.

ResUtilGetSzValue 는 확장 가능 및 여러 문자열 형식도 지원합니다.

요구 사항

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

추가 정보

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue