Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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