IWbemHiPerfProvider::CreateRefresher-Methode (wbemprov.h)

Artikel
08/27/2023

Die IWbemHiPerfProvider::CreateRefresher-Methode erstellt eine Aktualisierung. Die zurückgegebene Aktualisierung wird in nachfolgenden Aufrufen von IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject und IWbemHiPerfProvider::StopRefreshing verwendet.

Hinweis Wenn ein Anbieter diese Methode nicht implementiert, muss er WBEM_E_PROVIDER_NOT_CAPABLE zurückgeben. Ein Anbieter muss diese Methode implementieren, um Aktualisierungsvorgänge zu unterstützen.

Syntax

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

Parameter

[in] pNamespace

Ein IWbemServices-Zeiger zurück in die Windows-Verwaltung, die jede Anforderung des Anbieters verarbeiten kann. Der Anbieter sollte AddRef für diesen Zeiger aufrufen, wenn er während der Ausführung zurück in die Windows-Verwaltung ruft.

[in] lFlags

Reserviert. Dieser Parameter muss 0 (null) sein.

[out] ppRefresher

Zeiger, der den Verweis auf die Implementierung der IWbemRefresher-Schnittstelle durch den Anbieter enthält.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Hinweise

Der Anbieter muss eine eigene Implementierung der IWbemRefresher-Schnittstelle bereitstellen. Es ist für WMI gültig, mehrere Aktualisierungen anzufordern, die jeweils für eigene Aktualisierungsvorgänge verwendet werden.

Wenn Sie eine Aktualisierung freigeben, sollte der Anbieter alle aktualisierbaren Objekte oder Enumeratoren sauber, die der Aktualisierung hinzugefügt wurden.

Beispiele

Im folgenden Codebeispiel wird beschrieben, wie CreateRefresher implementiert wird.

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;

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemprov.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Wmiprvsd.dll