IWbemObjectAccess::GetPropertyHandle 메서드(wbemcli.h)
GetPropertyHandle 메서드는 속성을 식별하는 고유 핸들을 반환합니다. IWbemObjectAccess 메서드를 사용하여 속성 값을 읽거나 쓸 때 이 핸들을 사용하여 속성을 식별할 수 있습니다.
구문
HRESULT GetPropertyHandle(
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE *pType,
[out] long *plHandle
);
매개 변수
[in] wszPropertyName
속성 이름을 포함하는 16비트 유니코드 문자의 null로 끝나는 상수 문자열입니다.
[out] pType
속성의 CIM 형식을 반환하는 데 사용되는 CIMTYPE에 대한 포인터입니다.
[out] plHandle
속성 핸들을 반환하는 데 사용되는 정수에 대한 포인터입니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
설명
CIM_OBJECT 및 CIM_ARRAY 이외의 모든 데이터 형식에 대해 핸들을 검색할 수 있습니다. 반환된 핸들은 클래스의 모든 인스턴스에서 작동합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
지원되는 최소 서버 | Windows Server 2008 |
대상 플랫폼 | Windows |
헤더 | wbemcli.h(Wbemidl.h 포함) |
라이브러리 | Wbemuuid.lib |
DLL | Esscli.dll; Fastprox.dll; Wbemess.dll |