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.
A version of this page is also available for
4/8/2010

This function is a library-defined callback function that serves as the entry point for a Control Panel application.

Syntax 

LONG CPlApplet(
  HWND 
hwndCPl,
  UINT 
msg,
  LPARAM 
lParam1,
  LPARAM 
lParam2
);

Parameters

hwndCPl

[in] Handle to the main window of the controlling application. Use the hwndCPlparameter for other applications or windows that require a handle to a parent window.

msg

[in] Message being sent to the Control Panel application.

lParam1

[in] Additional message-specific information.

lParam2

[in] Additional message-specific information

Return Value

The return value depends on the message.

The CPlAppletfunction is an application-defined callback function that serves as the entry point for a Control Panel application. The APPLET_PROCtype defines a pointer to this callback function.

When the Control Panel starts, it loads all DLL files that have a .cpl file name extension (such as MyApplet.cpl) in the Windows folder. The Control Panel calls the CPlAppletfunction that was implemented and exported in each CPL file. The CPlAppletfunction must properly handle any of the control panel messages that are sent to it programmatically or via calls from the Control Panel.

If more than one Control Panel application is implemented in a .cpl file, a single CPlAppletfunction is used for all of the Control Panel applications.

Requirements

Header cpl.h
Library Developer Implemented
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also