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

아티클
08/27/2023

IWbemHiPerfProvider::CreateRefresher 메서드는 새로 고침을 만듭니다. 반환된 새로 고침은 IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject 및 IWbemHiPerfProvider::StopRefreshing에 대한 후속 호출에 사용됩니다.

참고 공급자가 이 메서드를 구현하지 않으면 WBEM_E_PROVIDER_NOT_CAPABLE 반환해야 합니다. 공급자는 새로 고침 작업을 지원하려면 이 메서드를 구현해야 합니다.

구문

HRESULT CreateRefresher(
  [in]  IWbemServices  *pNamespace,
  [in]  long           lFlags,
  [out] IWbemRefresher **ppRefresher
);

매개 변수

[in] pNamespace

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

[in] lFlags

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

[out] ppRefresher

IWbemRefresher 인터페이스의 공급자 구현에 대한 참조를 보유하는 포인터입니다.

반환 값

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

설명

공급자는 IWbemRefresher 인터페이스의 자체 구현을 제공해야 합니다. WMI가 여러 새로 고침을 요청하는 것은 유효하며, 각 새로 고침 작업은 자체 새로 고침 작업에 사용됩니다.

새로 고침을 해제할 때 공급자는 새로 고칠 수 있는 개체 또는 새로 고침에 추가된 열거자를 클린 합니다.

예제

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

HRESULT CHiPerfProvider::CreateRefresher(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */ long lFlags,
  /* [out] */ IWbemRefresher** ppRefresher
)
{
    // Allocate a new refresher
    //For Example:
    // CMyRefresher* pMyRefresher = new CMyRefresher();

    // Return the refresher to the ppRefresher
    // [out] parameter
    /*return pMyRefresher->QueryInterface(
     IID_IWbemRefresher, (void**) ppRefresher );*/
}

// Free memory resources.
// For Example:
//pNamespace->Release();
//ppRefresher->Release();
//delete[] pMyRefresher;

요구 사항


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