다음을 통해 공유


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