Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |