Share via


Initialize (Windows Embedded CE 6.0)

1/6/2010

Applies to Windows Embedded CE 6.0 R2 Update KB945975

This function initializes a connection between cetsc.exe and cetscoem.dll to enable the exchange of information about OEM customizations to the Windows Embedded CE Terminal Services Client (CETSC) user interface (UI).

This function is implemented by the OEM and called internally by cetsc.exe.

Syntax

EXTERN_C HRESULT WINAPI Initialize(
    PCALLBACKSETTINGSREAD  lpSettingsRead,
    PCALLBACKSETTINGSWRITE lpSettingsWrite,
    HWND hDlgMain,
    DWORD *pdwOptions,
    UINT *puAuxTabNum   
);

Parameters

Parameter Description

lpSettingsRead

[in] PCALLBACKSETTINGSREAD callback function passed in by cetsc.exe that is used by the OEM to retrieve the RDP settings.

For more information, see TscSettingsRead.

lpSettingsWrite

[in] PCALLBACKSETTINGSWRITE callback function passed in by cetsc.exe that is used by the OEM to write new RDP settings.

For more information, see TscSettingsWrite.

hDlgMain

[in] Window handle to the main dialog box passed in by cetsc.exe.

The OEM can use this handle to change the button settings of the dialog box in the Initialize implementation.

pdwOptions

[out] Options that enable you to hide the existing property pages in the main CETSC dialog box or to implement a Help procedure.

These options can be one or more of the following:

  • OEM_HIDE_TAB_DISPLAY (0x00000001)
  • OEM_HIDE_TAB_LOCALRES (0x00000002)
  • OEM_HIDE_TAB_RUN (0x00000004)
  • OEM_HIDE_TAB_PERF (0x00000008)
  • OEM_HIDE_TAB_ADVANCED (0x00000010)
  • OEM_HELP_PROC (0x00000020)

puAuxTabNum

[out] Indicates the number of additional, custom property pages that are provided by the OEM. These property pages are also known as auxiliary tabs.

Return Value

Returns S_OK if it is successful. Otherwise, returns ERROR_INVALID_PARAMETER.

Remarks

To customize CETSC UI, the OEM must provide a custom implementation of this function in the cetscoem.cpp source code file. The OEM uses this function to pass read and write callback functions for CETSC UI settings, and to obtain a handle to the main dialog box for CETSC UI. In the implementation of Initialize, the OEM should initialize all data structures and set the flags for the tabs that it wants to show in CETSC UI, together with the new property pages that it wants to add, also known as auxiliary tabs.

Requirements

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

See Also

Reference

CETSC UI Functions