CPL_NEWINQUIRE Nachricht

Wird an die CPlApplet-Funktion einer Systemsteuerung Anwendung gesendet, um Informationen zu einem Dialogfeld anzufordern, das von der Anwendung unterstützt wird.

Parameter

uAppNum

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

lpncpli

Die Adresse einer NEWCPLINFO-Struktur . Die Systemsteuerung Anwendung sollte diese Struktur mit Informationen zum Dialogfeld füllen.

Rückgabewert

Wenn die CPlApplet-Funktion diese Nachricht erfolgreich verarbeitet, sollte sie null zurückgeben.

Bemerkungen

Um die Leistung zu verbessern, sollten die meisten Anwendungen CPL_NEWINQUIRE ignorieren und stattdessen die CPL_INQUIRE-Meldung verarbeiten.

Die Systemsteuerung sendet die CPL_NEWINQUIRE-Nachricht einmal für jedes Dialogfeld, das von Ihrer Anwendung unterstützt wird. Die Systemsteuerung sendet auch eine CPL_INQUIRE 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 .

CPL_INQUIRE ist die bevorzugte Nachricht. Dies liegt daran, dass CPL_NEWINQUIRE Informationen in einer Form zurückgibt, die das System nicht zwischenspeichern kann. Folglich müssen Anwendungen, die CPL_NEWINQUIRE verarbeiten, jedes Mal geladen werden, wenn der Systemsteuerung die Informationen benötigt, was zu einer erheblichen Leistungsminderung führt.

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 Der 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 natürlich 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