Share via

InitializeCustomItem

  • Article

4/8/2010

Note

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

Use this call to initialize a custom item for the Home screen.

Syntax

HWND APIENTRY InitializeCustomItem (
  TODAYLISTITEM *ptli,
  HWND hwndParent 
);

Parameters

  • ptli
    [in] Pointer to the list item. The fields szName, tlit, dwOrder, fEnabled, fOptions and grfFlags will be filled. The function should check fEnabled and return NULL immediately if it is FALSE.
  • hwndParent
    [out] Handle of the parent window for the custom item window.

Return Value

HWND of the created window. NULL if the call fails.

Remarks

This API is called from the Shell's process by ordinal. When exporting this function from the custom item DLL, ordinal 240 should be specified in the DEF file.

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)