Provider::GetObject(CInstance*,long,CFrameworkQuery&) 메서드(provider.h)

[Provider 클래스는 현재 최종 상태로 간주되는 WMI 공급자 프레임워크의 일부이며 라이브러리에 영향을 미치는 비보안 관련 문제에 대해서는 더 이상 개발, 개선 또는 업데이트를 사용할 수 없습니다. 모든 새로운 개발에서는 MI API를 사용해야 합니다.]

GetObject 메서드는 클래스의 instance 검색하기 위해 WMI에서 호출됩니다.

구문

HRESULT GetObject(
        CInstance         *pInstance,
  [ref] long              lFlags,
        CFrameworkQuery & Query
);

매개 변수

pInstance

TBD

[ref] lFlags

Provider::GetObject 호출에서 요청한 대로 채울 속성 집합을 나타내는 쿼리 개체입니다.

공급자는 이러한 요청된 속성 값만 입력하여 상당한 성능 향상을 실현할 수 있습니다. 공급자는 CFrameworkQuery::IsPropertyRequired를 사용하여 요청되는 속성을 결정합니다. 그렇지 않으면 공급자가 모든 속성 값을 입력해야 합니다.

Query

TBD

반환 값

이 메서드의 기본 프레임워크 공급자 구현은 호출 메서드에 WBEM_E_PROVIDER_NOT_CAPABLE 반환합니다. IWbemServices::GetObject 메서드는 COM 반환 값을 구현하도록 선택할 수 있지만 일반적인 반환 값을 나열합니다.

설명

WMI는 IWbemServices::GetObject에 대한 클라이언트 호출에 대한 응답으로 GetObject를 호출하는 경우가 많습니다. Provider::GetObject의 WMI 버전은 키 속성만 채워진 instance 제공합니다. 반면 구현된 프레임워크 공급자는 다른 모든 속성을 채워야 합니다. 다음은 GetObject의 일반적인 재정의에 대해 설명합니다.

1. CInstance::GetCHString과 같은 CInstance에서 Get 메서드를 사용하여 키 속성을 읽어 요청된 WMI instance 결정합니다.
2. CInstance::SetByte 또는 CInstance::SetStringArray와 같은 CInstance 클래스의 여러 Set 메서드를 사용하여 instance 나머지 속성을 채웁합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	provider.h(FwCommon.h 포함)
라이브러리	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll