Share via

STRUCTURE NEWCPLINFOA (cpl.h)

  • Article

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 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 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.

Notes

L’en-tête cpl.h définit NEWCPLINFO comme un 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête cpl.h

Voir aussi

CPLINFO