Initialize
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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:
|
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 |