messaggio CPL_INQUIRE
Inviato alla funzione CPlApplet di un'applicazione Pannello di controllo per richiedere informazioni su una finestra di dialogo supportata dall'applicazione.
-
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.
Se la funzione CPlApplet elabora correttamente questo messaggio, deve restituire zero.
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.
Requisito | Valore |
---|---|
Client minimo supportato |
Windows XP [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|