Share via

3.1.4.12.4 IWbemRefreshingServices::RemoveObjectFromRefresher (Opnum 6)

  • Article

The IWbemRefreshingServices::RemoveObjectFromRefresher method MUST remove a CIM instance, which is identified by its CIM path, from the list of CIM instances that can be refreshed.

 HRESULT RemoveObjectFromRefresher(
   [in] _WBEM_REFRESHER_ID* pRefresherId,
   [in] long lId,
   [in] long lFlags,
   [in] DWORD dwClientRefrVersion,
   [out] DWORD* pdwSvrRefrVersion
 );

pRefresherId: MUST be a pointer to the _WBEM_REFRESHER_ID structure, as specified in section 2.2.21, that identifies the client that is requesting refreshing services. This parameter MUST NOT be NULL.

lId: This parameter MUST be an identifier to the object that is being removed. This parameter MUST NOT be NULL.

lFlags: This parameter is not used, and its value SHOULD be 0x0.

dwClientRefrVersion: MUST be the version of the client refresher. This value SHOULD<67> be 0x2. The server MUST allow all client versions.

pdwSvrRefrVersion: MUST be an output parameter, which MUST be the version of the server refresher. This value SHOULD be 0x1.

Return Values: This method MUST return an HRESULT value that MUST indicate the status of the method call. If there are no failures, the server MUST always return WBEM_E_NOT_AVAILABLE.<68>

WBEM_E_NOT_AVAILABLE (0x80041009)

In response to IWbemRefreshingServices::RemoveObjectFromRefresher, the server MUST set pdwSvrRefrVersion to 0x1 and return WBEM_E_NOT_AVAILABLE.

In case of failure, the server MUST set pdwSvrRefrVersion to 1 and MUST return an error in the format specified in section 2.2.11.