messaggio CPL_INQUIRE

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 trovarsi nell'intervallo zero fino a un valore inferiore al valore restituito in risposta al messaggio CPL_GETCOUNT (CPL_GETCOUNT - 1).

lpcpli

Indirizzo di una struttura CPLINFO . L'applicazione deve riempire questa struttura con identificatori di risorsa per l'icona, il nome breve, la descrizione e qualsiasi valore definito dall'utente associato alla finestra di dialogo.

Valore restituito

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

Commenti

Il Pannello di controllo invia il messaggio di CPL_INQUIRE una volta per ogni finestra di dialogo supportata dall'applicazione. Il Pannello di controllo invia anche un messaggio di CPL_NEWINQUIRE 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, farlo in risposta al messaggio di CPL_INIT .

Il messaggio CPL_NEWINQUIRE restituisce informazioni in un modulo che il sistema non può memorizzare nella cache. Per questo motivo, la maggior parte delle funzioni CPlApplet deve elaborare CPL_INQUIRE e ignorare CPL_NEWINQUIRE.

Le uniche applicazioni che devono usare CPL_NEWINQUIRE sono quelle che devono modificare l'icona o visualizzare 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 di CPL_NEWINQUIRE ogni volta che richiede l'icona e visualizza le stringhe, consentendo di specificare informazioni in base allo stato corrente del computer. Questa operazione è significativamente più lenta 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