IWbemConfigureRefresher::Remove method

The IWbemConfigureRefresher::Remove method is used to remove an object, enumerator, or nested refresher from a refresher.

Syntax


HRESULT Remove(
  [inlong lId,
  [inlong lFlags
);

Parameters

lId [in]

Integer that uniquely identifies the object to remove. You obtain this identifier when you first add an object to the refresher by calling IWbemConfigureRefresher::AddObjectByPath, IWbemConfigureRefresher::AddObjectByTemplate, IWbemConfigureRefresher::AddEnum, or IWbemConfigureRefresher::AddRefresher.

lFlags [in]

Bitmask of flags that modify the behavior of the Remove method. If this parameter is set to. WBEM_FLAG_REFRESH_AUTO_RECONNECT, the refresher attempts to automatically reconnect to a remote provider if the connection is broken. This is default behavior for this method. Specify WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT if you do not want the refresher to attempt to reconnect to a remote provider.

Return value

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

WBEM_S_NO_ERROR

The method was successful.

WBEM_S_FALSE

The specified identifier could not be removed.

WBEM_E_REFRESHER_BUSY

The refresher is busy with another operation.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

See also

IWbemConfigureRefresher
Accessing Performance Data in C++
Making an Instance Provider into a High-Performance Provider
IWbemHiPerfProvider
Performance Counter Provider

 

 

Show: