IWbemConfigureRefresher::AddRefresher method (wbemcli.h)

Article
02/22/2024

The IWbemConfigureRefresher::AddRefresher method adds a refresher to a refresher. The newly added refresher is called a "child refresher" or "nested refresher". You can use this method to create a single refresher containing more than one refresher that can be updated using a single call to the Refresh method.

Syntax

HRESULT AddRefresher(
  [in]  IWbemRefresher *pRefresher,
        long           lFlags,
  [out] long           *plId
);

Parameters

[in] pRefresher

Pointer to a IWbemRefresher object to nest in this refresher.

lFlags

Reserved. This parameter must be 0 (zero).

[out] plId

Pointer to an integer returned by the provider that uniquely identifies the refreshable object.

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

Users should not add recursively nested refreshers. The returned identifier can be used by the Remove function to remove the refresher. Although it is not necessary for the client to explicitly remove added refreshers, the client must call Release on the refreshers when they are no longer required.

Requirements

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