<div class="content" name="GetRemoteRefresher" uuid="09fcc398-c22f-4cf4-af67-2968b6d4e57e"><p>The IWbemRefreshingServices::GetRemoteRefresher method MUST
return an <a href="7e35e02b-092d-407f-a4bf-131f648b7691" data-linktype="relative-path">IWbemRemoteRefresher</a>
<a href="6837a7cb-ba2d-46b1-802c-fce2fd5a6ad6#gt_e5ba77ec-1a10-4a4e-a980-c81942237b34" data-linktype="relative-path">interface pointer</a>. This
pointer is needed by the client to refresh objects and enumerations.</p><dl>
<dd>
<div><pre> HRESULT GetRemoteRefresher(
   [in] _WBEM_REFRESHER_ID* pRefresherId,
   [in] long lFlags,
   [in] DWORD dwClientRefrVersion,
   [out] IWbemRemoteRefresher** ppRemRefresher,
   [out] GUID* pGuid,
   [out] DWORD* pdwSvrRefrVersion
 );
</pre></div>
</dd></dl><p><b>pRefresherId: </b>MUST be a pointer to the
_WBEM_REFRESHER_ID structure, as specified in section <a href="4785ade4-e762-4f7e-a87c-e00aa316a457" data-linktype="relative-path">2.2.21</a>, that identifies
the client that is requesting refreshing services. This parameter MUST NOT be
NULL.</p><p><b>lFlags: </b>This parameter is not used, and its
value SHOULD be 0x0.</p><p><b>dwClientRefrVersion: </b>MUST be the version of
the client refresher. This value SHOULD<a id="Appendix_A_Target_69"></a><a aria-label="Product behavior note 69" href="27182640-aa3f-43b6-941f-a77d25f798e8#Appendix_A_69" data-linktype="relative-path">&lt;69&gt;</a> be 0x2.
The server MUST allow all client versions.</p><p><b>ppRemRefresher: </b>MUST be a pointer to an
IWbemRemoteRefresher interface pointer that the client can use to call the <a href="b124c22e-4a76-48a7-b934-e8e8e33b56c0" data-linktype="relative-path">IWbemRemoteRefresher::RemoteRefresh</a>
method to refresh <a href="6837a7cb-ba2d-46b1-802c-fce2fd5a6ad6#gt_94e80069-5f2a-4281-a676-50ea656c4795" data-linktype="relative-path">CIM
instances</a> and enumerations. This parameter MUST NOT be NULL.</p><p><b>pGuid: </b>MUST be an output parameter that MUST
be a pointer to a <a href="6837a7cb-ba2d-46b1-802c-fce2fd5a6ad6#gt_f49694cc-c350-462d-ab8e-816f0103c6c1" data-linktype="relative-path">GUID</a>
value that MUST identify the returned refresher object. This parameter MUST NOT
be NULL.</p><p><b>pdwSvrRefrVersion: </b>MUST be an output parameter
that MUST be the version of the server refresher. The value of this parameter
SHOULD be 0x1.</p><p><b>Return Values: </b>This method MUST return an <a href="../ms-erref/0642cb2f-2075-4469-918c-4441e69c548a" data-linktype="relative-path">HRESULT</a>
value that MUST indicate the status of the method call. The server MUST return
WBEM_S_NO_ERROR (specified in section <a href="a2899649-a5a3-4b13-9ffa-d8394dcdac63" data-linktype="relative-path">2.2.11</a>) to indicate the
successful completion of the method.</p><dl>
<dd>
<p>In case of failure, the server MUST return an
HRESULT whose S (severity) bit is set as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section 2.1. The actual HRESULT value is implementation dependent.</p>
</dd>
<dd>
<p><b>WBEM_S_NO_ERROR</b> (0x00)</p>
</dd></dl><p>The <a href="6837a7cb-ba2d-46b1-802c-fce2fd5a6ad6#gt_f3ef2572-95cf-4c5c-b3c9-551fd648f409" data-linktype="relative-path">security
principal</a> that makes the call MUST have WBEM_REMOTE_ENABLE and WBEM_ENABLE
accesses to the namespace; otherwise, WBEM_E_ACCESS_DENIED MUST be returned.</p><p>The IWbemRefreshingServices::GetRemoteRefresher method evaluates
the <i>pRefresherID</i> parameter and MUST return an IWbemRemoteRefresher
interface pointer and a GUID that is randomly generated by the server in order
to identify this interface pointer. The <a href="e2c4f36d-dc59-48bb-bb51-821732610e17" data-linktype="relative-path">IWbemRefreshingServices</a>
interface pointer MUST have the same value as the one initially returned by the
<a href="cf79fb85-e0cb-4778-86de-03da6de4d5d8" data-linktype="relative-path">IWbemRefreshingServices::AddObjectToRefresher</a>,
<a href="24693f72-f828-42d0-86b7-f73ffd956739" data-linktype="relative-path">IWbemRefreshingServices::AddObjectToRefresherByTemplate</a>,
or <a href="7da35a37-b175-499d-a608-08a8c70e9f90" data-linktype="relative-path">IWbemRefreshingServices::AddEnumToRefresher</a>
method.</p><p>A successful call to
IWbemRefreshingServices::GetRemoteRefresher MUST return WBEM_S_NO_ERROR and
fill the <b>ppRemRefresher</b> and <b>pGuid</b> fields. The <b>pdwSvrRefrVersion</b>
field is reserved for future use and MUST be set to 0x1.</p><p>The returned IWbemRemoteRefresher interface MUST be used in
calls to the IWbemRemoteRefresher::RemoteRefresh and <a href="57da9a15-d329-44b8-ae90-fa7ac5f0f4d4" data-linktype="relative-path">IWbemRemoteRefresher::StopRefreshing</a>
methods.</p></div>