Share via


TscSettingsWrite (Windows Embedded CE 6.0)

1/6/2010

Applies to Windows Embedded CE 6.0 R2 Update KB945975

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

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

Requirements

Header oem_settings.h
Windows Embedded CE Windows Embedded CE 6.0 R2

See Also

Reference

CETSC UI Functions