NEWCPLINFOA-Struktur (cpl.h)

  • Artikel

Enthält Ressourceninformationen und einen von der Anwendung definierten Wert für ein Dialogfeld, das von einer Systemsteuerung Anwendung unterstützt wird.

Syntax

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;

Member

dwSize

Art: DWORD

Die Länge der Struktur in Bytes.

dwFlags

Art: DWORD

Dieses Element wird ignoriert.

dwHelpContext

Art: DWORD

Dieses Element wird ignoriert.

lData

Typ: LONG_PTR

Ein Zeiger auf die von der Anwendung definierten Daten. Wenn der Systemsteuerung die CPL_DBLCLK- und CPL_STOP-Nachrichten sendet, übergibt er diesen Wert zurück an Ihre Anwendung.

hIcon

Typ: HICON

Der Bezeichner des Symbols, das das Dialogfeld darstellt. Dieses Symbol soll von der Anwendung angezeigt werden, die die Systemsteuerung-Anwendung steuert.

szName[32]

Typ: TCHAR[32]

Eine NULL-beendete Zeichenfolge, die den Dialogfeldnamen enthält. Der Name soll unter dem Symbol angezeigt werden.

szInfo[64]

Typ: TCHAR[64]

Eine NULL-beendete Zeichenfolge, die die Beschreibung des Dialogfelds enthält. Die Beschreibung soll angezeigt werden, wenn das Symbol für das Dialogfeld ausgewählt ist.

szHelpFile[128]

Typ: TCHAR[128]

Dieses Element wird ignoriert.

Hinweise

Die CPlApplet-Funktion der Systemsteuerung-Anwendung gibt diese Informationen als Reaktion auf eine CPL_NEWINQUIRE Nachricht an den Systemsteuerung zurück.

Hinweis

Der cpl.h-Header definiert NEWCPLINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile cpl.h

Weitere Informationen

CPLINFO