<div class="content" name="RpcSyncRefreshRemoteNotifications" uuid="f5a1d020-e57b-4f8f-9aed-8386ff20243b"><p><b>RpcSyncRefreshRemoteNotifications</b> gets notification
information for all requested members. This SHOULD be called by a client if the
&#34;RemoteNotifyData Flags&#34; key in the <b>RpcPrintPropertiesCollection</b>
instance (section <span><a href="a2246cab-c69e-4bb7-a36f-149b1e4ab192" data-linktype="relative-path">2.2.4</a></span>), which was
returned as part of the notification from calling <b>RpcAsyncGetRemoteNotifications</b>
(section <span><a href="04a1267e-b533-42f8-84d2-aeaaf2654346" data-linktype="relative-path">3.1.4.9.4</a></span>), has the
<b>PRINTER_NOTIFY_INFO_DISCARDED</b> bit set (<span><a href="../ms-rprn/d42db7d5-f141-4466-8f47-0a4be14e2fc1" data-linktype="relative-path">[MS-RPRN]</a></span>
section <span><a href="../ms-rprn/033938db-cdc7-4541-8195-10b7b217d96a" data-linktype="relative-path">2.2.3.2</a></span>).</p><dl>
<dd>
<div><pre> HRESULT RpcSyncRefreshRemoteNotifications(
   [in] RMTNTFY_HANDLE hRpcHandle,
   [in] RpcPrintPropertiesCollection* pNotifyFilter,
   [out] RpcPrintPropertiesCollection** ppNotifyData
 );
</pre></div>
</dd></dl><p><b>hRpcHandle: </b>A remote notification handle that
was opened by using <b>RpcSyncRegisterForRemoteNotifications</b> (section <span><a href="a48d2fcd-81e8-4a94-841b-9b777c9723b4" data-linktype="relative-path">3.1.4.9.1</a></span>).</p><p><b>pNotifyFilter: </b>A pointer to an <b>RpcPrintPropertiesCollection</b>
instance that contains the caller-specified notification filter settings.</p><p><b>ppNotifyData: </b>A pointer to a variable that
receives a pointer to an <b>RpcPrintPropertiesCollection</b> instance that
contains the notification data.</p><p><b>Return Values: </b>This method returns either an <span><a href="a98de8d9-8e9e-4cd7-92f7-f9269206a41e#gt_799103ab-b3cb-4eab-8c55-322821b2b235" data-linktype="relative-path">HRESULT</a></span>
success value (<span><a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a></span>
section <span><a href="../ms-erref/0642cb2f-2075-4469-918c-4441e69c548a" data-linktype="relative-path">2.1</a></span>)
to indicate successful completion or an HRESULT error value to indicate
failure.</p><p><b>Exceptions Thrown:</b> This method MUST NOT throw any
exceptions other than those that are thrown by the underlying <span><a href="a98de8d9-8e9e-4cd7-92f7-f9269206a41e#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span>
protocol <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>.</p><p><b>Parameter Validation Requirements:</b> Upon receiving
this method call, the server MUST validate parameters as follows:</p><ul><li><p><span><span> 
</span></span>The <i>hRpcHandle</i> parameter MUST NOT be NULL and MUST be
associated with a valid notification object created by a call to <b>RpcSyncRegisterForRemoteNotifications</b>
(section 3.1.4.9.1).</p>
</li><li><p><span><span> 
</span></span>The <i>pNotifyFilter</i> parameter MUST point to an instance of <b>RpcPrintPropertiesCollection</b>
that has all the name-value pairs required to get notification data.</p>
</li></ul><p>If parameter validation fails, the server MUST return
immediately, with a failure indication in its response to the client.</p><p><b>Processing and Response Requirements:</b> If parameter
validation succeeds, the server MUST process the method call by:</p><ul><li><p><span><span> 
</span></span>Storing the notification data requested by the client in the <b>RpcPrintPropertiesCollection</b>
structure pointed to by <i>ppNotifyData</i>.</p>
</li><li><p><span><span> 
</span></span>Returning a response that contains the status of the operation.</p>
</li></ul><p>If the operation is successful, the server MUST make the
following changes to printer object data before returning the response:</p><ul><li><p><span><span> 
</span></span>Store the notification synchronization value in the <b>RpcPrintPropertiesCollection</b>
instance pointed to by <i>pNotifyFilter</i>, which corresponds to the &#34;RemoteNotifyFilter
Color&#34; key. Store this value with the client information in the list of
notification clients for the printer object or server so that the client can
use it in <b>RpcAsyncGetRemoteNotifications</b> calls.</p>
</li><li><p><span><span> 
</span></span>Delete the notification data associated with the notification
handle that has been successfully sent.</p>
</li></ul></div>