TscSettingsWrite (Compact 7)
3/12/2014
This function writes an updated value to the settings store that is implemented in cetsc.exe.
Cetsc.exe passes a reference to this callback function when it calls Initialize so that the OEM can use this function.
Syntax
HRESULT TscSettingsWrite (
UINT uID,
LPVOID val
);
Parameters
- uID
[in] Specifies the ID of the setting to update. For a list of the possible values, see the Remarks section.
- val
[in] Pointer to a data structure that contains the new value for the setting. String buffers must be null-terminated.
Return Value
Returns standard HRESULT values.
Remarks
The OEM can choose the preferred way to call this function in the source code.
Write operations that are initiated by this function are effective only for the duration of the UI.
To update a setting on the Display property page, the uID parameter can be one of the following values:
| ID | RDP setting |
|---|---|
OEMS_DESKTOP_WIDTH |
Desktop Width |
OEMS_DESKTOP_HEIGHT |
Desktop Height |
OEMS_START_FULL_SCREEN |
Whether the screen will start in full screen mode |
OEMS_SPAN_MONITORS |
Whether the screen will span multiple monditors |
OEMS_COLOR_DEPTH |
Color Depth BPP |
OEMS_DISPLAY_BBAR |
Whether RDP will show the connection bar |
OEMS_FULL_SCREEN_ALWAYS |
Whether the screen will always stay in full screen mode |
To update a setting on the Local Resource property page, the uID parameter can be one of the following values:
| ID | RDP setting |
|---|---|
OEMS_KEYBD_HOOK_MODE |
Keyboard Hook Mode |
OEMS_REDIR_SND_MODE |
Sound Redirection Mode |
OEMS_REDIR_DRIVE |
Whether Legacy Drive Redirection is enabled |
OEMS_REDIR_PRINTER |
Whether Printer Redirection is enabled |
OEMS_REDIR_PORT |
Whether COM Port Redirection is enabled |
OEMS_REDIR_CLIPBOARD |
Whether Clipboard Redirection is enabled |
OEMS_STORE_DRIVES |
OEM Store Drive |
OEMS_REDIR_SCARD |
Whether Smart Card Redirection is enabled |
OEMS_CAN_REDIR_PRINTER |
Whether the printer can be redirected |
OEMS_CAN_REDIR_CLIPBOARD |
Whether the Clipboard can be redirected |
OEMS_REDIR_COMPONENTS |
Number of redirected components |
OEMS_STORE_SUPPORTED_DEVICES |
Stores supported USB devices in device collection |
To update a setting on the Programs property page, the uID parameter can be one of the following values:
| ID | RDP setting |
|---|---|
OEMS_START_PROGRAMS |
Whether a start-up program is enabled |
OEMS_ALTERNATE_SHELL |
Alternative Shell Name |
OEMS_WORKING_DIR |
Working Directory Name |
To update a setting on the Experience property page, the uID parameter can be one of the following values:
| ID | RDP setting |
|---|---|
OEMS_PERF_FLAGS |
Performance Flags |
OEMS_AUTO_RECONNECT |
Whether Auto Reconnection is enabled |
To update a setting on the Advanced property page, the uID parameter can be one of the following values:
| ID | RDP setting |
|---|---|
OEMS_AUTH_LEVEL |
Authentication Level |
OEMS_AUTHLV_OVERRIDE |
Authentication Level Override |
OEMS_AUTHLV_OVERRIDE_EXISTS |
Whether Authentication Level Override Exists |
OEMS_CREDSSP_SUPPORT |
Whether CredSSP Support is enabled |