Metodo IWbemHiPerfProvider::StopRefreshing (wbemprov.h)

Articolo
03/13/2024

Il metodo IWbemHiPerfProvider::StopRefreshing arresta l'aggiornamento dell'oggetto o dell'enumeratore corrispondente all'identificatore specificato. L'aggiornamento WMI chiama questo metodo in risposta a una richiesta client a IWbemConfiguratorRefresher::Remove. Il provider deve controllare gli oggetti e gli enumeratori associati al aggiornatore per un identificatore corrispondente. Quando il provider trova un identificatore, il provider deve rimuovere o rilasciare l'enumeratore.

Nota Se un provider non implementa questo metodo, deve restituire WBEM_E_PROVIDER_NOT_CAPABLE. Un provider deve implementare StopRefreshing se implementa IWbemHiPerfProvider::CreateRefreshableEnum o IWbemHiPerfProvider::CreateRefreshableObject.

Sintassi

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

Parametri

[in] pRefresher

Puntatore a un oggetto IWbemRefresher che contiene un aggiornamento ottenuto chiamando IWbemHiPerfProvider::CreateRefresher.

[in] lId

Intero contenente un identificatore di aggiornamento che identifica in modo univoco l'oggetto per interrompere l'aggiornamento.

[in] lFlags

Intero contenente i flag.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.

Commenti

Non è necessario chiamare StopRefreshing per pulire un aggiornamento. È sufficiente eliminare semplicemente l'aggiornamento; ovvero, per rilasciare tutti i riferimenti a esso. L'eliminazione dell'aggiornamento causa la pulizia di tutti gli oggetti e gli enumeratori all'interno di esso.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemprov.h (include Wbemidl.h)
Libreria	Wbemuuid.lib
DLL	Wmiprvsd.dll