CPlApplet

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

Syntax

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

Parameters

hwndCPl
Identifier of the main window of the controlling application. Use the hwndCPl parameter for Control Panel application or other windows that require a handle to a parent window.
msg
Message being sent to the Control Panel application; one of the Control Panel API Messages.
lParam1
Additional message-specific information.
lParam2
Additional message-specific information.

Return Values

The return value depends on the message.

Remarks

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 CPlApplet function that was implemented and exported in each CPL file. The CPlApplet function must properly handle any of the Control Panel API Messages that are sent to it programatically or via calls from the Control Panel.

If more than one Control Panel application is implemented in a .cpl file, a single CPlApplet function is used for all them.

Example

See the Mybacklight code sample that is available after installing the Pocket PC SDK. By default, it is located at C:\Program Files\Windows CE Tools\wce420\POCKET PC 2003\Samples\Win32\.

Requirements

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later
Header: cpl.h