NEWCPLINFOA-Struktur (cpl.h)
Enthält Ressourceninformationen und einen anwendungsdefinierte Wert für ein Dialogfeld, das von einer Systemsteuerungsanwendung 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;
Angehörige
dwSize
Typ: DWORD-
Die Länge der Struktur in Byte.
dwFlags
Typ: DWORD-
Dieses Element wird ignoriert.
dwHelpContext
Typ: DWORD-
Dieses Element wird ignoriert.
lData
Typ: LONG_PTR
Ein Zeiger auf Daten, die von der Anwendung definiert werden. Wenn die Systemsteuerung die CPL_DBLCLK und CPL_STOP Nachrichten sendet, übergibt sie diesen Wert an Ihre Anwendung zurück.
hIcon
Typ: HICON-
Der Bezeichner des Symbols, das das Dialogfeld darstellt. Dieses Symbol soll von der Anwendung angezeigt werden, die die Systemsteuerungsanwendung steuert.
szName[32]
Typ: TCHAR[32]
Eine mit Null beendete Zeichenfolge, die den Namen des Dialogfelds enthält. Der Name soll unterhalb des Symbols angezeigt werden.
szInfo[64]
Typ: TCHAR[64]
Eine mit 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.
Bemerkungen
Die CPlApplet Funktion der Systemsteuerung gibt diese Informationen als Reaktion auf eine CPL_NEWINQUIRE Nachricht an die Systemsteuerung zurück.
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Header- | cpl.h |