OemProcXXX

Article
03/19/2010

Other versions of this page are also available for the following:

Windows Embedded CE 6.0 R3

Windows Mobile Not Supported Windows Embedded CE Supported

8/28/2008

Applies to Windows Embedded CE 6.0 R2 Update KB945975

This callback function is a dialog handle routine for each property page in Windows Embedded CE Terminal Services Client (CETSC) user interface (UI).

Syntax

BOOL CALLBACK OemProcXXX(
    HWND hwnd, 
    UINT msg, 
    WPARAM wParam, 
    LPARAM lParam
);

Parameters

hwnd
[in] Handle to the CETSC dialog box.

uMsg
[in] Specifies the message.

wParam
[in] Specifies additional message-specific information.

lParam
[in] Specifies additional message-specific information.

Return Value

Returns TRUE if it processed the message. Otherwise, returns FALSE.

Remarks

If an OEM wants to customize an existing property page, the OEM must implement this function. For existing property pages, the XXX is replaced with the property page name. For each property page, OemProcXXX is defined in the source code for the property page. The following chart shows the function name and its corresponding header file:

Function	Header file
OemProcDisplay	Propdisplay.h
OemProcLocalRes	Proplocalres.h
OemProcProg	Proprun.h
OemProcExp	Propperf.h
OemProcAdv	Propadv.h

For custom property pages, the OEM must define OemProcXXX in cetscoem.cpp and implement it in the custom property page source code. Template code for a custom property page is available in propaux1.h and propaux1.cpp. The OEM should replace XXX with the OEM custom name for the new property page. The function signature of OemProcXXX must match the following:

BOOL CALLBACK OemProcAux1(HWND hwnd, UINT msg, WPARAM wParam, 
                           LPARAM lParam);

The OEM may add a maximum of 16 additional custom property pages. Each custom property page requires its own OemProcXXX function.

Example

The following example code shows a starting point for implementing OemProcXXX for a property page called Aux1.

INT_PTR CALLBACK CPropAux1::PropPgAux1DialogProc (HWND hwndDlg,
                                                 UINT uMsg,
                                                 WPARAM wParam,
                                                 LPARAM lParam)
{
    TS_ENTERFN();

    switch(uMsg)
    {
        case WM_INITDIALOG:
        {
            //
            // Position the dialog within the tab
            //
            SetWindowPos( hwndDlg, HWND_TOP,
                      _rcTabDispayArea.left, _rcTabDispayArea.top,
                      _rcTabDispayArea.right - _rcTabDispayArea.left,
                      _rcTabDispayArea.bottom - _rcTabDispayArea.top,
                      0);

            return TRUE;
        }
        break; //WM_INITDIALOG

        case WM_TSC_ENABLECONTROLS:
        break;

        case WM_SAVEPROPSHEET:
        break;

        case WM_COMMAND:
        break;
    }

    TS_LEAVEFN();
    return 0;
}

BOOL CALLBACK OemProcAux1(HWND hwnd, UINT msg, WPARAM wParam, 
                          LPARAM lParam)
{
    return (BOOL)CPropAux1::StaticPropPgAux1DialogProc(hwnd, msg,
           wParam,
msg == WM_INITDIALOG ? (LPARAM)(g_CetscOEM->_pAux1Pg) :
           lParam);
}

Requirements

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

Share via