Provider::ExecQuery 메서드(provider.h)

  • 아티클

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

ExecQuery 메서드는 WQL(WMI 쿼리 언어) 쿼리를 처리하기 위해 WMI에서 호출됩니다.

구문

HRESULT ExecQuery(
        MethodContext     *pMethodContext,
  [ref] CFrameworkQuery & cQuery,
        long              lFlags
);

매개 변수

pMethodContext

이 호출의 컨텍스트 개체에 대한 포인터입니다. 이 값에는 클라이언트에서 지정한 모든 IWbemContext 속성이 포함됩니다. 또한 이 포인터는 WMI로의 모든 호출에 대한 매개 변수로 사용해야 합니다.

[ref] cQuery

공급자 프레임워크에서 이미 구문 분석한 쿼리에 대한 포인터입니다.

lFlags

쿼리 실행 작업에 대한 정보가 포함된 플래그의 비트 마스크입니다. IWbemServices::ExecQuery 메서드의 클라이언트에서 지정한 값입니다.

다음 플래그는 WMI에 의해 처리되고 필터링됩니다.

  • WBEM_FLAG_ENSURE_LOCATABLE
  • WBEM_FLAG_FORWARD_ONLY
  • WBEM_FLAG_BIDIRECTIONAL
  • WBEM_FLAG_USE_AMENDED_QUALIFIERS
  • WBEM_FLAG_RETURN_IMMEDIATELY
  • WBEM_FLAG_PROTOTYPE

반환 값

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

설명

WMI는 IWbemServices::ExecQuery에 대한 클라이언트 호출에 대한 응답으로 ExecQuery를 호출하는 경우가 많습니다. 여기서 클라이언트는 선택한 속성 목록 또는 WHERE 절을 전달합니다. 클라이언트 쿼리에 클래스를 설명하는 "ASSOCIATORS OF" 또는 "REFERENCES OF" 문이 포함된 경우 WMI는 ExecQuery 를 호출할 수도 있습니다. ExecQuery 구현에서 WBEM_E_NOT_SUPPORTED 반환하는 경우 클라이언트는 WMI를 사용하여 쿼리를 처리합니다.

WMI는 CreateInstanceEnum 의 구현을 호출하여 모든 인스턴스를 제공하여 쿼리를 처리합니다. 그런 다음 WMI는 인스턴스를 클라이언트로 반환하기 전에 결과 인스턴스를 필터링합니다. 따라서 만드는 ExecQuery 의 구현은 CreateInstanceEnum보다 더 효율적이어야 합니다.

다음은 ExecQuery의 일반적인 구현에 대해 설명합니다.

  1. Provider::CreateNewInstance를 사용하여 클래스의 빈 instance 만듭니다.
  2. 만들어야 하는 인스턴스의 하위 집합을 결정합니다.

    IsPropertyRequired와 같은 메서드를 사용하여 필요한 속성을 확인하고 GetValuesForProp을 사용하여 WMI에 필요한 인스턴스를 확인할 수 있습니다. 요청된 속성을 처리하는 다른 메서드로는 CFrameworkQuery::GetRequiredProperties, CFrameworkQuery::AllPropertiesAreRequired 및 CFrameworkQuery::KeysOnly가 있습니다.

  3. CInstance::SetByte 또는 CInstance::SetStringArray와 같은 CInstance 클래스의 Set 메서드를 사용하여 빈 instance 속성을 채웁합니다.
  4. CInstance::Commit을 사용하여 instance 클라이언트로 다시 보냅니다.
  5. 적절한 반환 값을 반환합니다.

    기본 ExecQuery 프레임워크 공급자 구현은 WBEM_E_PROVIDER_NOT_CAPABLE 반환합니다. ExecQuery를 구현하는 경우 IWbemServices::ExecQuery에 나열된 일반적인 반환 값을 사용해야 합니다. 그러나 필요한 경우 COM 반환 코드를 반환할 수 있습니다.

WMI는 프레임워크 공급자를 통해 "ASSOCIATORS OF" 또는 "REFERENCES OF" 쿼리를 보내지 않습니다. 대신 WMI는 스키마를 사용하여 해당 클래스와 관련된 클래스를 확인하고 적절한 WQL 쿼리를 생성하여 결과를 검색합니다. 따라서 "ASSOCIATORS OF" 및 "REFERENCES OF" 쿼리에 대한 추가 지원을 코딩할 필요가 없습니다.

그러나 프레임워크 공급자를 작성할 때는 다음 사항에 유의해야 합니다.

요구 사항

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