<div class="content" name="RpcWinStationUpdateSettings" uuid="ff68952d-edfe-4f81-aaf2-b2e37d2b29ef"><p>The RpcWinStationUpdateSettings method rereads settings for
all <span><a href="c41d3367-04c9-4c93-babf-9b5de834eb29#gt_8cc89bb9-be94-4672-8a5d-9947b91bc952" data-linktype="relative-path">WinStations</a></span>.
The caller MUST have WINSTATION_QUERY permission. The method checks whether the
caller has WINSTATION_QUERY permission (section <span><a href="4507e852-be3d-45b6-bc47-8ca0b552c94d" data-linktype="relative-path">3.1.1</a></span>) by setting
it as the Access Request mask, and fails if the caller does not have the
permission.<a id="Appendix_A_Target_206"></a><a aria-label="Product behavior note 206" href="7ce7f717-461b-4f18-9829-6690168c7707#Appendix_A_206" data-linktype="relative-path">&lt;206&gt;</a></p><dl>
<dd>
<div><pre> BOOLEAN RpcWinStationUpdateSettings(
   [in] SERVER_HANDLE hServer,
   [out] DWORD* pResult,
   [in] DWORD SettingsClass,
   [in] DWORD SettingsParameters
 );
</pre></div>
</dd></dl><p><b>hServer: </b> A handle to the server object of
type <span><a href="49484cdf-2feb-4de9-a588-5d01cf8995dc" data-linktype="relative-path">SERVER_HANDLE</a></span>. The <i>hServer</i>
argument MUST be obtained from a previous call to <span><a href="fd6f339d-f5dd-452c-a9a9-ec753c22a36a" data-linktype="relative-path">RpcWinStationOpenServer</a></span>.</p><p><b>pResult: </b> Failure error code if the call to
RpcWinStationUpdateSettings failed. If the call was successful, this parameter
MUST be STATUS_SUCCESS (0x00000000).</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>STATUS_SUCCESS 0x00000000</td>
  <td>The call was successful.</td>
 </tr><tr>
  <td>STATUS_ACCESS_DENIED 0xC0000022</td>
  <td>The caller does not have permission to read the settings.</td>
 </tr><tr>
  <td>STATUS_INVALID_PARAMETER 0xC000000D</td>
  <td>Unrecognized SettingsClass.</td>
 </tr></tbody></table>
</dd></dl><p><b>SettingsClass: </b> The class for which to update
settings.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>WINSTACFG_SESSDIR 0x00000001</td>
  <td>Contacts Session Directory to reread the WinStation settings.&lt;207&gt;</td>
 </tr><tr>
  <td>WINSTACFG_LEGACY 0x00000000</td>
  <td>Rereads settings from the local registry for the configured winstations. This does the same thing as RpcWinStationReadRegistry.</td>
 </tr></tbody></table>
</dd></dl><p><b>SettingsParameters:</b>  MUST be 0.</p><p><b>Return Values:</b>  Returns TRUE if the call
succeeded, and FALSE if the method failed. On failure, pResult indicates the
failure status code.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01 TRUE</td>
  <td>Successful completion.</td>
 </tr><tr>
  <td>0x00 FALSE</td>
  <td>Method call failed.</td>
 </tr></tbody></table>
</dd></dl><p> </p></div>