/*****************************************************************************\ * * * cpl.h - Control panel extension DLL definitions * * * * Version 3.10 * * * * Copyright 1992 - 1998 Microsoft Corp. All rights reserved * * * ******************************************************************************/ /* * General rules for being installed in the Control Panel: * * 1) The DLL must export a function named CPlApplet which will handle * the messages discussed below. * 2) If the applet needs to save information in CONTROL.INI minimize * clutter by using the application name [MMCPL.appletname]. * 2) If the applet is refrenced in CONTROL.INI under [MMCPL] use * the following form: * ... * [MMCPL] * uniqueName=c:\mydir\myapplet.dll * ... * * * The order applet DLL's are loaded by CONTROL.EXE is not guaranteed. * Control panels may be sorted for display, etc. * */ #ifndef _INC_CPL #define _INC_CPL #include /* Assume byte packing throughout */ #ifdef __cplusplus extern "C" { /* Assume C declarations for C++ */ #endif /* __cplusplus */ /* * CONTROL.EXE will answer this message and launch an applet * * WM_CPL_LAUNCH * * wParam - window handle of calling app * lParam - LPTSTR of name of applet to launch * * WM_CPL_LAUNCHED * * wParam - TRUE/FALSE if applet was launched * lParam - NULL * * CONTROL.EXE will post this message to the caller when the applet returns * (ie., when wParam is a valid window handle) * */ #define WM_CPL_LAUNCH (WM_USER+1000) #define WM_CPL_LAUNCHED (WM_USER+1001) /* A function prototype for CPlApplet() */ //typedef LRESULT (APIENTRY *APPLET_PROC)(HWND hwndCpl, UINT msg, LPARAM lParam1, LPARAM lParam2); typedef LONG (APIENTRY *APPLET_PROC)(HWND hwndCpl, UINT msg, LONG lParam1, LONG lParam2); /* The data structure CPlApplet() must fill in. */ typedef struct tagCPLINFO { int idIcon; /* icon resource id, provided by CPlApplet() */ int idName; /* name string res. id, provided by CPlApplet() */ int idInfo; /* info string res. id, provided by CPlApplet() */ LONG lData; /* user defined data */ } CPLINFO, *LPCPLINFO; typedef struct tagNEWCPLINFOA { DWORD dwSize; /* similar to the commdlg */ DWORD dwFlags; DWORD dwHelpContext; /* help context to use */ LONG lData; /* user defined data */ HICON hIcon; /* icon to use, this is owned by CONTROL.EXE (may be deleted) */ CHAR szName[32]; /* short name */ CHAR szInfo[64]; /* long name (status line) */ CHAR szHelpFile[128];/* path to help file to use */ } NEWCPLINFOA, *LPNEWCPLINFOA; typedef struct tagNEWCPLINFOW { DWORD dwSize; /* similar to the commdlg */ DWORD dwFlags; DWORD dwHelpContext; /* help context to use */ LONG lData; /* user defined data */ HICON hIcon; /* icon to use, this is owned by CONTROL.EXE (may be deleted) */ WCHAR szName[32]; /* short name */ WCHAR szInfo[64]; /* long name (status line) */ WCHAR szHelpFile[128];/* path to help file to use */ } NEWCPLINFOW, *LPNEWCPLINFOW; #ifdef UNICODE typedef NEWCPLINFOW NEWCPLINFO; typedef LPNEWCPLINFOW LPNEWCPLINFO; #else typedef NEWCPLINFOA NEWCPLINFO; typedef LPNEWCPLINFOA LPNEWCPLINFO; #endif // UNICODE #if(WINVER >= 0x0400) #define CPL_DYNAMIC_RES 0 // This constant may be used in place of real resource IDs for the idIcon, // idName or idInfo members of the CPLINFO structure. Normally, the system // uses these values to extract copies of the resources and store them in a // cache. Once the resource information is in the cache, the system does not // need to load a CPL unless the user actually tries to use it. // CPL_DYNAMIC_RES tells the system not to cache the resource, but instead to // load the CPL every time it needs to display information about an item. This // allows a CPL to dynamically decide what information will be displayed, but // is SIGNIFICANTLY SLOWER than displaying information from a cache. // Typically, CPL_DYNAMIC_RES is used when a control panel must inspect the // runtime status of some device in order to provide text or icons to display. #endif /* WINVER >= 0x0400 */ /* The messages CPlApplet() must handle: */ #define CPL_INIT 1 /* This message is sent to indicate CPlApplet() was found. */ /* lParam1 and lParam2 are not defined. */ /* Return TRUE or FALSE indicating whether the control panel should proceed. */ #define CPL_GETCOUNT 2 /* This message is sent to determine the number of applets to be displayed. */ /* lParam1 and lParam2 are not defined. */ /* Return the number of applets you wish to display in the control */ /* panel window. */ #define CPL_INQUIRE 3 /* This message is sent for information about each applet. */ /* A CPL SHOULD HANDLE BOTH THE CPL_INQUIRE AND CPL_NEWINQUIRE MESSAGES. */ /* The developer must not make any assumptions about the order or dependance */ /* of CPL inquiries. */ /* lParam1 is the applet number to register, a value from 0 to */ /* (CPL_GETCOUNT - 1). lParam2 is a far ptr to a CPLINFO structure. */ /* Fill in CPLINFO's idIcon, idName, idInfo and lData fields with */ /* the resource id for an icon to display, name and description string ids, */ /* and a long data item associated with applet #lParam1. This information */ /* may be cached by the caller at runtime and/or across sessions. */ /* To prevent caching, see CPL_DYNAMIC_RES, above. */ #define CPL_SELECT 4 /* The CPL_SELECT message has been deleted. */ #define CPL_DBLCLK 5 /* This message is sent when the applet's icon has been double-clicked */ /* upon. lParam1 is the applet number which was selected. lParam2 is the */ /* applet's lData value. */ /* This message should initiate the applet's dialog box. */ #define CPL_STOP 6 /* This message is sent for each applet when the control panel is exiting. */ /* lParam1 is the applet number. lParam2 is the applet's lData value. */ /* Do applet specific cleaning up here. */ #define CPL_EXIT 7 /* This message is sent just before the control panel calls FreeLibrary. */ /* lParam1 and lParam2 are not defined. */ /* Do non-applet specific cleaning up here. */ #define CPL_NEWINQUIRE 8 /* Same as CPL_INQUIRE execpt lParam2 is a pointer to a NEWCPLINFO struct. */ /* A CPL SHOULD HANDLE BOTH THE CPL_INQUIRE AND CPL_NEWINQUIRE MESSAGES. */ /* The developer must not make any assumptions about the order or dependance */ /* of CPL inquiries. */ #if(WINVER >= 0x0400) #define CPL_STARTWPARMSA 9 #define CPL_STARTWPARMSW 10 #ifdef UNICODE #define CPL_STARTWPARMS CPL_STARTWPARMSW #else #define CPL_STARTWPARMS CPL_STARTWPARMSA #endif /* this message parallels CPL_DBLCLK in that the applet should initiate ** its dialog box. where it differs is that this invocation is coming ** out of RUNDLL, and there may be some extra directions for execution. ** lParam1: the applet number. ** lParam2: an LPSTR to any extra directions that might exist. ** returns: TRUE if the message was handled; FALSE if not. */ #endif /* WINVER >= 0x0400 */ /* This message is internal to the Control Panel and MAIN applets. */ /* It is only sent when an applet is invoked from the Command line */ /* during system installation. */ #define CPL_SETUP 200 #ifdef __cplusplus } #endif /* __cplusplus */ #include #endif /* _INC_CPL */