IWbemHiPerfProvider::GetObjects 메서드(wbemprov.h)

아티클
08/27/2023

IWbemHiPerfProvider::GetObjects 메서드는 제공된 배열에 개체의 키가 아닌 속성을 삽입합니다. WMI 는IWbemServices::GetObject 호출에 대한 응답으로 GetObjects를 호출합니다. 공급자가 GetObjects를 구현하지 않는 경우 WMI는 IWbemHiPerfProvider::CreateRefreshableObject 메서드를 호출하여 GetObject 요청을 처리하려고 시도합니다.

참고 공급자가 이 메서드를 구현하지 않으면 WBEM_E_PROVIDER_NOT_CAPABLE 반환해야 합니다.

구문

HRESULT GetObjects(
  [in]      IWbemServices     *pNamespace,
  [in]      long              lNumObjects,
  [in, out] IWbemObjectAccess **apObj,
            long              lFlags,
            IWbemContext      *pContext
);

매개 변수

[in] pNamespace

IWbemServices는 공급자가 수행한 모든 요청을 처리할 수 있는 Windows Management에 대한 포인터입니다. 공급자는 실행 중에 Windows Management로 다시 호출하려는 경우 이 포인터에서 AddRef 를 호출해야 합니다.

[in] lNumObjects

검색하는 개체의 수를 포함하는 정수입니다.

[in, out] apObj

IWbemObjectAccess 개체의 배열에 대한 포인터입니다. GetObjects 메서드는 각 개체의 키 속성을 이 배열에 삽입합니다.

lFlags

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

pContext

일반적으로 NULL; 그렇지 않으면 하나 이상의 동적 클래스 공급자에 필요한 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 특정 공급자 설명서에 지정해야 합니다. 이 매개 변수에 대한 자세한 내용은 WMI 호출을 참조하세요.

반환 값

이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.

설명

요청된 개체에는 키 속성이 채워집니다.

예제

다음 코드 예제에서는 GetObjects를 구현하는 방법을 설명합니다.

HRESULT CMyHiPerfProvider::GetObjects(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */  long lNumObjects,
  /* [in,out] */IWbemObjectAccess **apObj,
  /* [in] */long lFlags,
  /* [in] */IWbemContext *pCtx
)
{

  for ( long i = 0; i < lNumObjects; i++ )
  {
      // Validate the instance (that is, ensure
      // the path is good); if it fails, return
      // the error.

      // For example, create a method that validates
      // the IWbemObjectAccess instance and returns
      // false if validation failed.
      /*if ( !ValidateInstance( apObj[i] ) )
          return WBEM_E_NOT_FOUND;*/

      // Fill out the instance.
      // For example, create a method that assigns
      // a value to the IWbemObjectAccess instance.
      /*FillInstance( apObj[i] );*/
  }

  return WBEM_S_NO_ERROR;
}

요구 사항


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