Edit

Share via

IWbemHiPerfProvider::StopRefreshing method (wbemprov.h)

  • Article

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

See also

Developing a WMI Provider

IWbemHiPerfProvider

Making an Instance Provider into a High-Performance Provider

Performance Counter Provider

Writing an Instance Provider