CPLINFO-Struktur (cpl.h)

Enthält Ressourceninformationen und einen von der Anwendung definierten Wert für ein Dialogfeld, das von einer Systemsteuerung-Anwendung unterstützt wird. Die CPlApplet-Funktion der Systemsteuerung Anwendung gibt diese Informationen als Reaktion auf eine CPL_INQUIRE Nachricht an den Systemsteuerung zurück.

Syntax

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

Member

idIcon

Typ: int

Der Ressourcenbezeichner des Symbols, das das Dialogfeld darstellt.

idName

Typ: int

Der Ressourcenbezeichner der Zeichenfolge, die den Kurznamen für das Dialogfeld enthält. Dieser Name soll unter dem Symbol angezeigt werden.

idInfo

Typ: int

Der Ressourcenbezeichner der Zeichenfolge, die die Beschreibung für das Dialogfeld enthält, das angezeigt werden soll, wenn das Anwendungssymbol ausgewählt wird.

lData

Typ: LONG_PTR

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

Hinweise

Wenn sich das Symbol oder die Anzeigezeichenfolgen des Dialogfelds je nach Zustand des Computers ändern können, können Sie den CPL_DYNAMIC_RES Wert für die Elemente idIcon, idName oder idInfo angeben, anstatt einen gültigen Ressourcenbezeichner anzugeben. Dies bewirkt, dass der Systemsteuerung die CPL_NEWINQUIRE Nachricht jedes Mal sendet, wenn das Symbol und die Anzeigezeichenfolgen benötigt werden. Die Verwendung dieser Technik ist jedoch erheblich langsamer, da die Systemsteuerung Ihre Anwendung jedes Mal laden muss, wenn sie die CPL_NEWINQUIRE Nachricht sendet.

Anforderungen

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