3.2.4.5.1 IWbemRefreshingServices::AddObjectToRefresher and IWbemRefreshingServices::AddObjectToRefresherByTemplate

The client MUST pass the _WBEM_REFRESHER_ID that is generated as specified in section 2.2.21 to the IWbemRefreshingServices::AddObjectToRefresher and IWbemRefreshingServices::AddObjectToRefresherByTemplate methods.

When the client calls the IWbemRefreshingServices::AddObjectToRefresher or IWbemRefreshingServices::AddObjectToRefresherByTemplate method with pRefresherId generated by the client, the server returns the refresher information in the _WBEM_REFRESH_INFO structure if the method succeeds.

The client MUST allow all the version numbers that are returned by the server in pdwSvrRefrVersion.

If the returned _WBEM_REFRESH_INFO structure contains m_lType as WBEM_REFRESH_TYPE_REMOTE, the m_Info structure contains the _WBEM_REFRESH_INFO_REMOTE structure. The client MUST obtain the IWbemRemoteRefresher from the m_pRefresher in _WBEM_REFRESH_INFO_REMOTE. The client MUST use the IWbemRemoteRefresher::RemoteRefresh method to get the updated object. If the client wants to remove the particular object from the remote refresher, the client MUST use m_lCancelId, which is returned in _WBEM_REFRESH_INFO, to invoke the IWbemRemoteRefresher::StopRefreshing method.

If the returned _WBEM_REFRESH_INFO structure contains m_lType as WBEM_REFRESH_TYPE_NON_HIPERF, the client MUST retrieve the CIM instance using IWbemServices::GetObject or IWbemServices::GetObjectAsync on the initial IWbemServices interface.

When the IWbemRefreshingServices::AddObjectToRefresher or IWbemRefreshingServices::AddObjectToRefresherByTemplate method fails, the server does not return the _WBEM_REFRESH_INFO structure.