CPL_INIT

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

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 version 1.0, an error is recognized when the applet 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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Cpl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

FreeLibrary

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.