3.7.4.1.27 RpcWinStationUpdateSettings (Opnum 58)

The RpcWinStationUpdateSettings method rereads settings for all WinStations. The caller MUST have WINSTATION_QUERY permission. The method checks whether the caller has WINSTATION_QUERY permission (section 3.1.1) by setting it as the Access Request mask, and fails if the caller does not have the permission.<204>

 BOOLEAN RpcWinStationUpdateSettings(
   [in] SERVER_HANDLE hServer,
   [out] DWORD* pResult,
   [in] DWORD SettingsClass,
   [in] DWORD SettingsParameters
 );

hServer:  A handle to the server object of type SERVER_HANDLE. The hServer argument MUST be obtained from a previous call to RpcWinStationOpenServer.

pResult:  Failure error code if the call to RpcWinStationUpdateSettings failed. If the call was successful, this parameter MUST be STATUS_SUCCESS (0x00000000).

Value	Meaning
STATUS_SUCCESS 0x00000000	The call was successful.
STATUS_ACCESS_DENIED 0xC0000022	The caller does not have permission to read the settings.
STATUS_INVALID_PARAMETER 0xC000000D	Unrecognized SettingsClass.

SettingsClass:  The class for which to update settings.

Value	Meaning
WINSTACFG_SESSDIR 0x00000001	Contacts Session Directory to reread the WinStation settings.<205>
WINSTACFG_LEGACY 0x00000000	Rereads settings from the local registry for the configured winstations. This does the same thing as RpcWinStationReadRegistry.

SettingsParameters:  MUST be 0.

Return Values:  Returns TRUE if the call succeeded, and FALSE if the method failed. On failure, pResult indicates the failure status code.

Return value/code	Description
0x01 TRUE	Successful completion.
0x00 FALSE	Method call failed.