messaggio CPL_NEWINQUIRE

Inviato alla funzione CPlApplet di un'applicazione Pannello di controllo per richiedere informazioni su una finestra di dialogo supportata dall'applicazione.

Parametri

uAppNum

Numero della finestra di dialogo. Questo numero deve essere compreso nell'intervallo da zero a uno minore del valore restituito in risposta al messaggio di CPL_GETCOUNT (CPL_GETCOUNT - 1).

lpncpli

Indirizzo di una struttura NEWCPLINFO . L'applicazione Pannello di controllo deve riempire questa struttura con informazioni sulla finestra di dialogo.

Valore restituito

Se la funzione CPlApplet elabora correttamente questo messaggio, dovrebbe restituire zero.

Commenti

Per ottenere prestazioni migliori, la maggior parte delle applicazioni deve ignorare CPL_NEWINQUIRE ed elaborare invece il messaggio CPL_INQUIRE .

Il Pannello di controllo invia il messaggio CPL_NEWINQUIRE una volta per ogni finestra di dialogo supportata dall'applicazione. Il Pannello di controllo invia anche un messaggio di CPL_INQUIRE per ogni finestra di dialogo. Questi messaggi vengono inviati immediatamente dopo il messaggio di CPL_GETCOUNT . Tuttavia, il sistema non garantisce l'ordine in cui vengono inviati i messaggi CPL_INQUIRE e CPL_NEWINQUIRE .

È possibile eseguire l'inizializzazione per la finestra di dialogo quando si riceve CPL_INQUIRE. Se è necessario allocare memoria, eseguire questa operazione in risposta al messaggio di CPL_INIT .

CPL_INQUIRE è il messaggio preferito. Ciò è dovuto al fatto che CPL_NEWINQUIRE restituisce informazioni in un modulo che il sistema non può memorizzare nella cache. Di conseguenza, le applicazioni che elaborano CPL_NEWINQUIRE devono essere caricate ogni volta che il Pannello di controllo necessita delle informazioni, con conseguente riduzione significativa delle prestazioni.

Le uniche applicazioni che devono usare CPL_NEWINQUIRE sono quelle che devono modificare l'icona o visualizzare le stringhe in base allo stato del computer. In questo caso, il gestore CPL_INQUIRE deve specificare il valore CPL_DYNAMIC_RES per i membri idIcon, idName o idInfo della struttura CPLINFO , anziché specificare un identificatore di risorsa valido. In questo modo il Pannello di controllo invia il messaggio CPL_NEWINQUIRE ogni volta che richiede l'icona e le stringhe di visualizzazione, consentendo di specificare le informazioni in base allo stato corrente del computer. Naturalmente, questo è significativamente più lento rispetto all'uso delle informazioni memorizzate nella cache.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Cpl.h