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

  • 아티클

IWbemConfigureRefresher::AddObjectByPath 메서드는 개체 경로를 지정하여 개체를 새로 고침에 추가합니다.

구문

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

매개 변수

[in] pNamespace

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

[in] wszPath

새로 고침에 추가하는 개체의 개체 경로를 포함하는 16비트 유니코드 문자의 null로 끝나는 상수 문자열입니다.

[in] lFlags

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

[in] pContext

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

[out] ppRefreshable

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

[out] plId

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

반환 값

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

설명

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

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

요구 사항

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

추가 정보

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

IWbemConfigureRefresher

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

성능 카운터 공급자