IWbemConfigureRefresher::AddObjectByTemplate 메서드(wbemcli.h)

IWbemConfigureRefresher::AddObjectByTemplate 메서드를 사용하면 IWbemClassObject instance 템플릿을 지정하여 새로 고칠 개체를 새로 고칠 수 있습니다. 개체를 새로 고침에 추가할 개체 경로를 생성하기 어려운 경우 이 메서드를 사용합니다.

참고AddObjectByTemplate 메서드를 호출하려면 먼저 instance 개체의 키 속성을 입력해야 합니다.

 

구문

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

매개 변수

pNamespace

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

[in] pTemplate

instance 템플릿을 포함하는 IWbemClassObject 개체에 대한 포인터입니다.

[in] lFlags

이 메서드의 동작을 수정하는 플래그의 비트 마스크입니다. 이 매개 변수가 WBEM_FLAG_USE_AMENDED_QUALIFIERS 설정되면 반환된 instance 지역화된 한정자(사용 가능한 경우)가 포함됩니다.

[in] pContext

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

[out] ppRefreshable

새로 고칠 수 있는 instance 개체를 포함하는 IWbemClassObject 개체에 대한 참조를 보유하는 포인터입니다. 클라이언트는 더 이상 필요하지 않은 경우 반환된 개체에서 Release 를 호출해야 합니다.

[out] plId

이 새로 고침 가능한 개체를 고유하게 식별하는 공급자가 반환한 정수에 대한 포인터입니다.

반환 값

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

설명

제공된 instance High-Performance 공급자에서 제공하는 유효한 개체를 지정해야 합니다. 새로 고침 작업이 진행되는 동안 클라이언트에서 반환된 개체를 수정해서는 안 됩니다. 반환된 식별자는 Remove 함수에서 개체를 제거하는 데 사용할 수 있습니다.

사용자가 추가된 개체를 명시적으로 제거할 필요는 없습니다. 클라이언트는 더 이상 필요하지 않은 경우 반환된 개체에서 Release 를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wbemcli.h(Wbemidl.h 포함)
라이브러리	Wbemuuid.lib

추가 정보

C++에서 성능 데이터 액세스

IWbemConfigureRefresher

인스턴스 공급자를 고성능 공급자로 만들기

성능 카운터 공급자