CPL_INQUIRE Nachricht

Wird an die CPlApplet-Funktion einer Systemsteuerung Anwendung gesendet, um Informationen zu einem Von der Anwendung unterstützten Dialogfeld anzufordern.

Parameter

uAppNum

Die Dialogfeldnummer. Diese Zahl muss im Bereich null bis eins kleiner als der Wert liegen, der als Antwort auf die CPL_GETCOUNT-Nachricht zurückgegeben wird (CPL_GETCOUNT – 1).

lpcpli

Die Adresse einer CPLINFO-Struktur . Die Anwendung muss diese Struktur mit Ressourcenbezeichnern für das Symbol, den kurzen Namen, die Beschreibung und alle dem Dialogfeld zugeordneten benutzerdefinierten Werte füllen.

Rückgabewert

Wenn die CPlApplet-Funktion diese Nachricht erfolgreich verarbeitet, sollte null zurückgegeben werden.

Bemerkungen

Die Systemsteuerung sendet die CPL_INQUIRE-Nachricht einmal für jedes Dialogfeld, das von Ihrer Anwendung unterstützt wird. Die Systemsteuerung sendet auch eine CPL_NEWINQUIRE Nachricht für jedes Dialogfeld. Diese Nachrichten werden unmittelbar nach der CPL_GETCOUNT Nachricht gesendet. Das System garantiert jedoch nicht die Reihenfolge, in der die CPL_INQUIRE und CPL_NEWINQUIRE Nachrichten gesendet werden.

Sie können die Initialisierung für das Dialogfeld durchführen, wenn Sie CPL_INQUIRE erhalten. Wenn Sie Arbeitsspeicher zuweisen müssen, tun Sie dies als Reaktion auf die CPL_INIT-Nachricht .

Die CPL_NEWINQUIRE Nachricht gibt Informationen in einer Form zurück, die das System nicht zwischenspeichern kann. Aus diesem Grund sollten die meisten CPlApplet-FunktionenCPL_INQUIRE verarbeiten und CPL_NEWINQUIRE ignorieren.

Die einzigen Anwendungen, die CPL_NEWINQUIRE verwenden sollten, sind diejenigen, die ihr Symbol oder die Anzeigezeichenfolgen basierend auf dem Zustand des Computers ändern müssen. In diesem Fall sollte Ihr CPL_INQUIRE-Handler den CPL_DYNAMIC_RES-Wert für die Elemente idIcon, idName oder idInfo der CPLINFO-Struktur 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, sodass Sie Informationen basierend auf dem aktuellen Zustand des Computers angeben können. Dies ist deutlich langsamer als die Verwendung zwischengespeicherter Informationen.

Anforderungen

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