IWbemHiPerfProvider::StopRefreshing-Methode (wbemprov.h)

Artikel
03/03/2024

Die IWbemHiPerfProvider::StopRefreshing-Methode beendet das Aktualisieren des Objekts oder Enumerators, das dem angegebenen Bezeichner entspricht. Der WMI Refresher ruft diese Methode als Antwort auf eine Clientanforderung an IWbemConfiguratorRefresher::Remove auf. Der Anbieter sollte die Objekte und Enumeratoren, die der Aktualisierung zugeordnet sind, auf einen übereinstimmenden Bezeichner überprüfen. Wenn der Anbieter einen Bezeichner findet, sollte der Anbieter den Enumerator entfernen oder freigeben.

Hinweis Wenn ein Anbieter diese Methode nicht implementiert, muss er WBEM_E_PROVIDER_NOT_CAPABLE zurückgeben. Ein Anbieter sollte StopRefreshing implementieren, wenn er IWbemHiPerfProvider::CreateRefreshableEnum oder IWbemHiPerfProvider::CreateRefreshableObject implementiert.

Syntax

HRESULT StopRefreshing(
  [in] IWbemRefresher *pRefresher,
  [in] long           lId,
  [in] long           lFlags
);

Parameter

[in] pRefresher

Ein Zeiger auf ein IWbemRefresher-Objekt , das eine Aktualisierung enthält, die durch aufrufen von IWbemHiPerfProvider::CreateRefresher abgerufen wird.

[in] lId

Eine ganze Zahl, die einen Aktualisierungsbezeichner enthält, der das Objekt eindeutig identifiziert, das die Aktualisierung beenden soll.

[in] lFlags

Eine ganze Zahl, die die Flags enthält.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Hinweise

Es ist nicht erforderlich, StopRefreshing aufzurufen, um eine Aktualisierung zu sauber. Es reicht aus, die Auffrischung einfach zu löschen. das heißt, alle Verweise darauf freizugeben. Das Löschen der Aktualisierung führt zur Bereinigung aller Objekte und Enumeratoren darin.

Anforderungen

Anforderung	Wert
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