3.2.4.5.3 IWbemRefreshingServices::GetRemoteRefresher

  • Article

When invoking the methods of the IWbemRemoteRefresher interface, if the connection is lost and reported to the client as an RPC disconnect error (as specified in [MS-ERREF]), the client SHOULD try to reconnect to WMI by obtaining IWbemServices as specified in section 3.2.3 and to obtain the IWbemRemoteRefresher interface using the IWbemServices interface as specified in section 3.2.4.5, and SHOULD call the IWbemRefreshingServices::GetRemoteRefresher method on this interface.

If the IWbemRefreshingServices::GetRemoteRefresher method call succeeds, the client gets a GUID of the remote refresher in the pGuid parameter.

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

If the GUID is equal to the GUID that is returned in WBEM_REFRESH_INFO_REMOTE when the remote refresher is first received by calling either IWbemRefreshingServices::AddEnumToRefresher, IWbemRefreshingServices::AddObjectToRefresher, or IWbemRefreshingServices::AddObjectToRefresherByTemplate, the client MUST NOT call IWbemRefreshingServices::ReconnectRemoteRefresher. The client SHOULD call IWbemRemoteRefresher::RemoteRefresh on the IWbemRemoteRefresher interface, which is obtained by using IWbemRefreshingServices::GetRemoteRefresher to refresh the object. The client MUST NOT call the methods on the IWbemRemoteRefresher interface whose connection is initially lost.

If the GUID is not equal to the GUID that is returned in WBEM_REFRESH_INFO_REMOTE when the remote refresher is first received by calling either IWbemRefreshingServices::AddEnumToRefresher, IWbemRefreshingServices::AddObjectToRefresher or IWbemRefreshingServices::AddObjectToRefresherByTemplate, the client MUST call IWbemRefreshingServices::ReconnectRemoteRefresher to reconnect all the objects to the refresher. The client MUST NOT call methods on the new remote refresher until IWbemRefreshingServices::ReconnectRemoteRefresher is executed successfully. The client MUST NOT call methods on the IWbemRemoteRefresher interface whose connection is lost initially.

If the IWbemRefreshingServices::GetRemoteRefresher method call fails, the client SHOULD retry after allowing a time-out.