Funzione ExitWindowsEx (winuser.h)

Disconnette l'utente interattivo, arresta il sistema o arresta e riavvia il sistema. Invia il messaggio di WM_QUERYENDSESSION a tutte le applicazioni per determinare se possono essere terminati.

Sintassi

BOOL ExitWindowsEx(
  [in] UINT  uFlags,
  [in] DWORD dwReason
);

Parametri

[in] uFlags

Tipo di arresto. Questo parametro deve includere uno dei valori seguenti.

Questo parametro può facoltativamente includere uno dei valori seguenti.

[in] dwReason

Motivo dell'avvio dell'arresto. Questo parametro deve essere uno dei codici di motivo di arresto del sistema.

Se questo parametro è zero, il codice SHTDN_REASON_FLAG_PLANNED motivo non verrà impostato e pertanto l'azione predefinita è un arresto non definito registrato come "Nessun titolo per questo motivo potrebbe essere trovato". Per impostazione predefinita, è anche un arresto non pianificato. A seconda della configurazione del sistema, un arresto non pianificato attiva la creazione di un file contenente le informazioni sullo stato del sistema, che può ritardare l'arresto. Pertanto, non usare zero per questo parametro.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero. Poiché la funzione viene eseguita in modo asincrono, un valore restituito diverso da zero indica che l'arresto è stato avviato. Non indica se l'arresto avrà esito positivo. È possibile che il sistema, l'utente o un'altra applicazione interrompa l'arresto.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione ExitWindowsEx restituisce non appena ha avviato il processo di arresto. Il logoff o l'arresto procede in modo asincrono. La funzione è progettata per arrestare tutti i processi nella sessione di accesso del chiamante. Pertanto, se non si è l'utente interattivo, la funzione può avere esito positivo senza arrestare effettivamente il computer. Se non si è l'utente interattivo, usare la funzione InitiateSystemShutdown o InitiateSystemShutdownEx .

Un valore restituito diverso da zero non indica che il logoff è stato o avrà esito positivo. L'arresto è un processo asincrono e può verificarsi a lungo dopo che la chiamata API è stata restituita o meno. Anche se il valore di timeout è zero, l'arresto può comunque essere interrotto da applicazioni, servizi o anche dal sistema. Il valore restituito non zero indica che la convalida dei diritti e dei parametri è stata completata e che il sistema ha accettato la richiesta di arresto.

Quando questa funzione viene chiamata, il chiamante deve specificare se le applicazioni con modifiche non salvate devono essere chiuse in modo imprevisto. Se il chiamante sceglie di non forzare la chiusura di queste applicazioni e un'applicazione con modifiche non salvate viene eseguita nella sessione della console, l'arresto rimarrà in corso fino a quando l'utente ha eseguito l'accesso alla sessione della console interrompendo l'arresto, salva le modifiche, chiude l'applicazione o forza la chiusura dell'applicazione. Durante questo periodo, l'arresto potrebbe non essere interrotto tranne per l'utente della console e un altro arresto potrebbe non essere avviato.

La chiamata a questa funzione con il valore del parametro uFlags impostato su EWX_FORCE evita questa situazione. Tenere presente che questa operazione può causare la perdita di dati.

Per impostare una priorità di arresto per un'applicazione rispetto ad altre applicazioni nel sistema, usare la funzione SetProcessShutdownParameters .

Durante un'operazione di arresto o disconnessione, le applicazioni in esecuzione possono rispondere a una richiesta di arresto specifica. Se questa ora scade prima che tutte le applicazioni siano state arrestate, il sistema visualizza un'interfaccia utente che consente all'utente di arrestare in modo forcibmente il sistema o di annullare la richiesta di arresto. Se viene specificato il valore EWX_FORCE, il sistema forza l'esecuzione delle applicazioni a interrompere la scadenza dell'ora.

Se viene specificato il valore EWX_FORCEIFHUNG, il sistema forza la chiusura delle applicazioni bloccate e non visualizza la finestra di dialogo.

I processi della console ricevono un messaggio di notifica separato, CTRL_SHUTDOWN_EVENT o CTRL_LOGOFF_EVENT, in quanto la situazione garantisce. Un processo della console indirizza questi messaggi alla funzione HandlerRoutine . ExitWindowsEx invia questi messaggi di notifica in modo asincrono; pertanto, un'applicazione non può presupporre che i messaggi di notifica della console siano stati gestiti quando viene restituita una chiamata a ExitWindowsEx .

Per arrestare o riavviare il sistema, il processo chiamante deve usare la funzione AdjustTokenPrivileges per abilitare il privilegio SE_SHUTDOWN_NAME. Per altre informazioni, vedere Esecuzione con privilegi speciali.

Esempio

Per un esempio, vedere Come arrestare il sistema.

Requisiti

Vedi anche

RegolaTokenPrivileges

HandlerRoutine

Disconnessione

SetProcessShutdownParameters

Arresto

Funzioni di arresto del sistema