CPL_INIT (Windows CE 5.0)

Send Feedback

This message is sent to a Control Panel application to prompt it to perform global initialization, especially memory allocation.

Syntax

CPL_INIT wParam1 = 0;  lParam2 = 0;

Parameters

  • wParam
    Not used.
  • lParam
    Not used.

Return Values

If initialization succeeds, the CPlApplet function should return nonzero. Otherwise, it should return zero.

If CPlApplet returns zero, the controlling application ends communication and releases the DLL that contains the Control Panel application.

Remarks

The return value is not checked by the Control Panel Explorer.

In Windows CE 1.0, an error is recognized when the program does not fill the NEWCPLINFO structure properly in response to the CPL_NEWINQUIRE message.

Because this is the only way a Control Panel application can signal an error condition, the application should allocate memory in response to this message.

This message is sent immediately after the DLL that contains the application is loaded.

Requirements

Pocket PC: Pocket PC 2000 and later
OS Versions: Windows CE 1.0 and later
Header: Cpl.h

See Also

Standard Shell Messages | FreeLibrary

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.