CPL_INQUIRE

The CPL_INQUIRE message is sent to a Control Panel dynamic-link library (DLL) to request information about an application that the DLL supports.

This message is provided for backward compatibility with the Microsoft Windows operating system, version 3.1. An application should use the CPL_NEWINQUIRE message instead of the CPL_INQUIRE message.

Parameters

lParam1

Specifies the application number. This number must be in the range zero through one less than the value returned in response to the CPL_GETCOUNT message (CPL_GETCOUNT – 1).

lParam2

Specifies a far pointer to a CPLINFO structure. The DLL should fill this structure with resource identifiers for the icon, short name, description, and any user-defined value associated with the application. The CPLINFO structure has the following form:

#include <cpl.h>

typedef struct tagCPLINFO { /* cpli */
    int   idIcon;
    int   idName;
    int   idInfo;
    LONG  lData;
} CPLINFO;

Return Value

The Control Panel DLL returns zero if it processes this message successfully.

Comments

This message is sent once for each application serviced by the DLL. It is sent immediately after the CPL_GETCOUNT message. A DLL can perform application-level initialization when it receives this message. Memory should be allocated in response to the CPL_INIT message.

See Also

CPL_GETCOUNT, CPL_INIT, CPL_NEWINQUIRE