CWbemProviderGlue::GetInstancesByQuery(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,LPCWSTR) 메서드(wbemglue.h)

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

GetInstancesByQuery 메서드는 특정 쿼리와 일치하는 인스턴스 목록을 검색합니다.

구문

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

매개 변수

query

실행할 쿼리입니다.

pList

쿼리에서 지정한 쿼리와 일치하는 인스턴스의 연결된 목록입니다.

pMethodContext

현재 컨텍스트에 대한 포인터입니다. 교착 상태를 방지하려면 컨텍스트를 제공해야 합니다. Provider::EnumerateInstances 또는 Provider::ExecQuery에서 공급자에 전달된 컨텍스트를 사용하거나 CInstance::GetMethodContext를 사용하여 instance 가져옵니다. 이 매개 변수는 NULL이 아니어야 합니다.

pszNamespace

인스턴스를 포함하는 네임스페이스에 대한 포인터입니다. NULL이면 기본 네임스페이스인 루트\cimv2가 사용됩니다.

반환 값

메서드는 작업이 성공한 경우 WBEM_S_NO_ERROR 반환하고, 작업이 실패한 경우 WBEM_E_FAILED 또는 다른 HRESULT 오류 코드를 반환합니다.

설명

GetInstancesByQuery 메서드를 사용하면 프레임워크 공급자가 WMI API를 호출하지 않고도 다른 공급자의 데이터에 액세스할 수 있습니다. 프레임워크 공급자는 적절한 인스턴스를 반환하는 GetInstancesByQuery에 쿼리를 전달합니다.

성능상의 이유로 이 함수를 호출할 때 필요한 속성만 지정합니다(예: "SELECT *" 대신 "SELECT 이름"을 지정).

요구 사항

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