PWLX_MESSAGE_BOX funzione di callback (winwlx.h)
[La funzione WlxMessageBox non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]
La funzione WlxMessageBox viene chiamata da GINA per creare, visualizzare e gestire una finestra di messaggio.
Sintassi
PWLX_MESSAGE_BOX PwlxMessageBox;
int PwlxMessageBox(
[in] HANDLE hWlx,
[in] HWND hwndOwner,
[in] LPWSTR lpszText,
[in] LPWSTR lpszTitle,
[in] UINT fuStyle
)
{...}
Parametri
[in] hWlx
Specifica l'handle Winlogon passato a GINA nella chiamata WlxInitialize .
[in] hwndOwner
Specifica la finestra proprietario della finestra di messaggio da creare. Se questo parametro è NULL, la finestra di messaggio non ha una finestra proprietario.
[in] lpszText
Punta a una stringa con terminazione null che contiene il messaggio da visualizzare.
[in] lpszTitle
Punta a una stringa con terminazione null usata per il titolo della finestra di dialogo. Se questo parametro è NULL, viene usato l'errore di titolo predefinito.
[in] fuStyle
Specifica il contenuto e il comportamento della finestra di dialogo. Questo parametro può essere una combinazione dei valori seguenti.
| Valore | Significato |
|---|---|
|
La finestra di messaggio contiene tre pulsanti di comando: Interruzione, Ripetizione tentativi e Ignora. |
|
L'utente deve rispondere alla finestra di messaggio prima di continuare a funzionare nella finestra identificata dal parametro hWndOwner . Tuttavia, l'utente può passare a finestre di altre applicazioni per funzionare.
A seconda della gerarchia di finestre nell'applicazione, l'utente può essere in grado di passare ad altre finestre all'interno dell'applicazione. Tutte le finestre figlio dell'elemento padre della finestra di messaggio vengono disabilitate automaticamente, ma le finestre popup non sono. MB_APPLMODAL è il valore predefinito se non viene specificato né MB_SYSTEMMODAL né MB_TASKMODAL. |
|
Il desktop attualmente che riceve l'input deve essere un desktop predefinito; in caso contrario, la funzione ha esito negativo. Un desktop predefinito è quello in cui viene eseguita un'applicazione dopo l'accesso dell'utente. |
|
Il primo pulsante è il pulsante predefinito. Si noti che il primo pulsante è sempre il valore predefinito a meno che non sia specificato MB_DEFBUTTON2 o MB_DEFBUTTON3. |
|
Il secondo pulsante è un pulsante predefinito. |
|
Il terzo pulsante è un pulsante predefinito. |
|
Il quarto pulsante è un pulsante predefinito. |
|
Un'icona costituita da una lettera minuscola in un cerchio viene visualizzata nella finestra di messaggio. |
|
Viene visualizzata un'icona punto esclamativo nella finestra di messaggio. |
|
Viene visualizzata un'icona a mano nella finestra di messaggio. |
|
Un'icona costituita da una lettera minuscola in un cerchio viene visualizzata nella finestra di messaggio. |
|
Viene visualizzata un'icona del punto interrogativo nella finestra di messaggio. |
|
Viene visualizzata un'icona di segno di arresto nella finestra di messaggio. |
|
La finestra di messaggio contiene un pulsante di comando: OK. |
|
La finestra di messaggio contiene due pulsanti di comando: OK e Annulla. |
|
La finestra di messaggio contiene due pulsanti di comando: ripetizione dei tentativi e annullamento. |
|
Il chiamante è un servizio che notifica un evento all'utente. La funzione visualizza una finestra di messaggio sul desktop attivo corrente, anche se non è presente alcun utente connesso al computer. |
|
La finestra di messaggio diventa la finestra di primo piano. Internamente, Windows chiama la funzione SetForegroundWindow per la finestra di messaggio. |
|
Tutte le applicazioni vengono sospese fino a quando l'utente risponde alla finestra di messaggio. A meno che l'applicazione non specifichi MB_ICONHAND, la finestra di messaggio non diventa modale finché non viene creata. Di conseguenza, la finestra proprietario e altre finestre continuano a ricevere messaggi risultanti dall'attivazione. Usare le caselle di messaggio modali di sistema per notificare all'utente errori gravi e potenzialmente dannosi che richiedono un'attenzione immediata, ad esempio, che non eseguono memoria. |
|
Uguale a MB_APPLMODAL tranne che tutte le finestre di primo livello che appartengono all'attività corrente vengono disabilitate se il parametro hWndOwner è NULL. Usare questo flag quando l'applicazione chiamante o la libreria non dispone di un handle di finestra disponibile, ma deve comunque impedire l'input ad altre finestre nell'applicazione corrente senza sospendere altre applicazioni. |
|
La finestra di messaggio contiene due pulsanti di comando: Sì e No. |
|
La finestra di messaggio contiene tre pulsanti di comando: Sì, No e Annulla. |
Valore restituito
Se la funzione ha esito negativo o se non è presente memoria sufficiente per creare la finestra di messaggio, il valore restituito è zero.
Se la funzione ha esito positivo, il valore restituito è uno dei valori della voce di menu seguente restituiti dalla finestra di dialogo.
| Codice restituito | Descrizione |
|---|---|
|
È stato selezionato il pulsante Di interruzione. |
|
È stato selezionato il pulsante Annulla. |
|
È stato selezionato il pulsante Ignora. |
|
Un pulsante non è stato selezionato. |
|
È stato selezionato il pulsante OK. |
|
È stato selezionato il pulsante Ripetizione tentativi. |
|
È stato selezionato il pulsante Sì. |
Commenti
La funzione WlxMessageBox non gestisce gli eventi sas e non è adatta alle finestre di dialogo di sicurezza. Usare la funzione WlxDialogBox, WlxDialogBoxIndirect o WlxDialogBoxIndirectParam per le finestre di dialogo di sicurezza.
WlxMessageBox duplica la funzione Windows MessageBox , con l'eccezione che questa funzione consente anche a Winlogon di timeout la finestra di dialogo. Per altre informazioni, vedere MessageBox.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winwlx.h |