OemProcXXX (Windows Embedded CE 6.0)

1/6/2010

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:

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

See Also

Reference

CETSC UI Functions