CustomItemOptionsDlgProc

4/8/2010

Note

This section applies to the Windows Classic Home screen and not the Windows Default Home screen.

This export should be implemented if the custom item needs an Options dialog box in the Home screen Settings screen.

Syntax

BOOL APIENTRY CustomItemOptionsDlgProc (
  HWND hDlg, 
  UINT message, 
  UINT wParam, 
  LONG lParam 
);

Parameters

  • hDlg
    [in] Handle to the dialog box.
  • message
    [in] Specifies the window message ID.
  • wParam
    [in] Specifies additional message-specific information.
  • lParam
    [in] Specifies additional message-specific information.

Return Value

TRUE indicates the message was processed.

Remarks

This API is called from the Shell's process by ordinal. When exporting this function from the custom item DLL, ordinal 241 should be specified in the DEF file. This function is only required if "Options" = 1 in the registry.

Requirements

Header todaycmn.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also

Concepts

Home Screen Functions (Windows Mobile Professional)