GetPropertyHandle 함수

속성을 식별하는 고유한 핸들을 반환합니다.

참고

이 API는 내부 전용입니다. 개발자 코드에서 사용할 수 없습니다.

구문

HRESULT GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

매개 변수

vFunc
[in] 이 매개 변수는 사용되지 않습니다.

ptr
[in] IWbemObjectAccess 인스턴스에 대한 포인터입니다.

wszPropertyName
[in] 속성 이름을 포함하는 UTF16 인코딩 문자의 null로 끝나는 문자열입니다.

pType
[out] 속성의 CIM 형식을 나타내는 CIMTYPE 열거형 멤버에 대한 포인터입니다.

pHandle
[out] 속성 핸들을 포함하는 정수에 대한 포인터입니다.

반환 값

이 함수가 반환하는 다음 값은 WbemCli.h 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수	값	Description
WBEM_E_NOT_FOUND	0x80041002	지정된 속성 이름을 찾을 수 없습니다.
WBEM_E_INVALID_PARAMETER	0x80041008	매개 변수가 잘못된 경우
WBEM_E_NOT_SUPPORTED	0x8004100c	요청한 속성은 CIM_OBJECT 또는 CIM_ARRAY 형식입니다.
WBEM_S_NO_ERROR	0	함수 호출에 성공했습니다.

설명

이 함수는 IWbemClassObject::GetPropertyHandle 메서드에 대한 호출을 래핑합니다.

IWbemObjectAccess 메서드를 사용하여 속성 값을 읽거나 쓸 때 이 핸들을 사용하여 속성을 식별할 수 있습니다.

CIM_OBJECT 및 CIM_ARRAY를 제외한 모든 데이터 형식의 속성에 대해 핸들을 검색할 수 있습니다. 반환된 핸들은 클래스의 모든 인스턴스에서 작동합니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: WMINet_Utils.idl

.NET Framework 버전: 4.7.2부터 사용 가능

참고 항목

• WMI 및 성능 카운터(관리되지 않는 API 참조)