IWbemHiPerfProvider::StopRefreshing method (wbemprov.h)

Article
10/13/2021

The IWbemHiPerfProvider::StopRefreshing method stops refreshing the object or enumerator corresponding to the supplied identifier. The WMI Refresher calls this method in response to a client request to IWbemConfiguratorRefresher::Remove. The provider should check the objects and enumerators associated with the refresher for a matching identifier. When the provider finds an identifier, the provider should remove or release the enumerator.

Note If a provider does not implement this method, it must return WBEM_E_PROVIDER_NOT_CAPABLE. A provider should implement StopRefreshing if it implements IWbemHiPerfProvider::CreateRefreshableEnum or IWbemHiPerfProvider::CreateRefreshableObject.

Syntax

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

Parameters

[in] pRefresher

A pointer to a IWbemRefresher object that contains a refresher obtained by calling IWbemHiPerfProvider::CreateRefresher.

[in] lId

An integer containing a refresher identifier that uniquely identifies the object to stop refreshing.

[in] lFlags

An integer containing the flags.

Return value

This method returns an HRESULT indicating the status of the method call. The following list lists the value contained within an HRESULT.

Remarks

It is not necessary to call StopRefreshing to clean up a refresher. It is sufficient simply to delete the refresher; that is, to release all references to it. Deleting the refresher causes the cleanup of all objects and enumerators within it.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	wbemprov.h (include Wbemidl.h)
Library	Wbemuuid.lib
DLL	Wmiprvsd.dll