PWLX_MESSAGE_BOX funzione di callback (winwlx.h)

Articolo
03/09/2024

[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.

Nota Le DLL GINA vengono ignorate in Windows Vista.

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
MB_ABORTRETRYIGNORE	La finestra di messaggio contiene tre pulsanti di comando: Interruzione, Ripetizione tentativi e Ignora.
MB_APPLMODAL	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.
MB_DEFAULT_DESKTOP_ONLY	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.
MB_DEFBUTTON1	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.
MB_DEFBUTTON2	Il secondo pulsante è un pulsante predefinito.
MB_DEFBUTTON3	Il terzo pulsante è un pulsante predefinito.
MB_DEFBUTTON4	Il quarto pulsante è un pulsante predefinito.
MB_ICONASTERISK	Un'icona costituita da una lettera minuscola in un cerchio viene visualizzata nella finestra di messaggio.
MB_ICONEXCLAMATION	Viene visualizzata un'icona punto esclamativo nella finestra di messaggio.
MB_ICONHAND	Viene visualizzata un'icona a mano nella finestra di messaggio.
MB_ICONINFORMATION	Un'icona costituita da una lettera minuscola in un cerchio viene visualizzata nella finestra di messaggio.
MB_ICONQUESTION	Viene visualizzata un'icona del punto interrogativo nella finestra di messaggio.
MB_ICONSTOP	Viene visualizzata un'icona di segno di arresto nella finestra di messaggio.
MB_OK	La finestra di messaggio contiene un pulsante di comando: OK.
MB_OKCANCEL	La finestra di messaggio contiene due pulsanti di comando: OK e Annulla.
MB_RETRYCANCEL	La finestra di messaggio contiene due pulsanti di comando: ripetizione dei tentativi e annullamento.
MB_SERVICE_NOTIFICATION	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.
MB_SETFOREGROUND	La finestra di messaggio diventa la finestra di primo piano. Internamente, Windows chiama la funzione SetForegroundWindow per la finestra di messaggio.
MB_SYSTEMMODAL	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.
MB_TASKMODAL	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.
MB_YESNO	La finestra di messaggio contiene due pulsanti di comando: Sì e No.
MB_YESNOCANCEL	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.

Nota Se una finestra di messaggio ha un pulsante Annulla , la funzione restituisce il valore IDCANCEL se il tasto ESC viene premuto o viene fatto clic sul pulsante Annulla . Se la finestra di messaggio non ha alcun pulsante Annulla , premere ESC non ha alcun effetto.

Codice restituito	Descrizione
IDABORT	È stato selezionato il pulsante Di interruzione.
IDCANCEL	È stato selezionato il pulsante Annulla.
IDIGNORE	È stato selezionato il pulsante Ignora.
IDNO	Un pulsante non è stato selezionato.
IDOK	È stato selezionato il pulsante OK.
IDRETRY	È stato selezionato il pulsante Ripetizione tentativi.
IDYES	È 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