STRUCTURE NEWCPLINFOA (cpl.h)
Contient des informations sur les ressources et une valeur définie par l’application pour une boîte de dialogue prise en charge par une application du Panneau de configuration.
Syntaxe
typedef struct tagNEWCPLINFOA {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHelpContext;
LONG_PTR lData;
HICON hIcon;
CHAR szName[32];
CHAR szInfo[64];
CHAR szHelpFile[128];
} NEWCPLINFOA, *LPNEWCPLINFOA;
Membres
dwSize
Type : DWORD
Longueur de la structure, en octets.
dwFlags
Type : DWORD
Ce membre est ignoré.
dwHelpContext
Type : DWORD
Ce membre est ignoré.
lData
Type : LONG_PTR
Pointeur vers les données définies par l’application. Lorsque le Panneau de configuration envoie les messages CPL_DBLCLK et CPL_STOP, il transmet cette valeur à votre application.
hIcon
Type : HICON
Identificateur de l’icône qui représente la boîte de dialogue. Cette icône est destinée à être affichée par l’application qui contrôle l’application du Panneau de configuration.
szName[32]
Type : TCHAR[32]
Chaîne terminée par null qui contient le nom de la boîte de dialogue. Le nom est destiné à être affiché sous l’icône.
szInfo[64]
Type : TCHAR[64]
Chaîne terminée par null contenant la description de la boîte de dialogue. La description est destinée à être affichée lorsque l’icône de la boîte de dialogue est sélectionnée.
szHelpFile[128]
Type : TCHAR[128]
Ce membre est ignoré.
Remarques
La fonction CPlApplet de l’application Panneau de configuration retourne ces informations au Panneau de configuration en réponse à un message CPL_NEWINQUIRE.
Note
L’en-tête cpl.h définit NEWCPLINFO comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| d’en-tête | cpl.h |