Initialize (Compact 7)
3/12/2014
This function initializes a connection between cetsc.exe and cetscoem.dll to enable the exchange of information about OEM customizations to the Windows Embedded Compact 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.