Codici motivo di arresto del sistema

I codici di motivo di arresto vengono usati dalle funzioni ExitWindowsEx e InitiateSystemShutdownEx nel parametro dwReason .

Un massimo di MAX_NUM_REASONS codici motivo verrà elaborato dal sistema. MAX_NUM_REASONS è definito in reason.h.

Di seguito sono riportati i flag principali per motivi. Indicano il tipo di problema generale.

Di seguito sono riportati i flag per motivi secondari. Modificano il flag principale specificato. È possibile usare qualsiasi motivo secondario insieme a qualsiasi motivo principale, ma alcune combinazioni non hanno senso.

I flag facoltativi seguenti forniscono informazioni aggiuntive sull'evento.

Commenti

Le combinazioni seguenti vengono riconosciute dal sistema. La tabella indica la stringa visualizzata in Shutdown Event Tracker e fornisce una descrizione più dettagliata. La stringa predefinita è "Nessun titolo per questo motivo".

È anche possibile definire i propri motivi di arresto e aggiungerli al Registro di sistema. Ogni codice motivo deve essere archiviato come valore del Registro di sistema nella chiave seguente:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Reliability\UserDefined\default_system_language_ID <>

Questa chiave contiene i nomi di valore del formato seguente: xxxxx; nnn; nnnnn. I punti e virgola delimitano i componenti di un nome di valore.

Xxxxx

Uno-cinque dei flag di controllo seguenti (non è possibile usare altri caratteri).

Flag	Descrizione
P	Arresto pianificato; in caso contrario, un arresto non pianificato.
C	È necessario un commento. Questo flag deve essere usato con S.
B	È necessario un ID. Questo flag deve essere usato con D.
S	Visualizzare la finestra di dialogo di arresto prevista. È necessario usare S, D o S e D.
D	Visualizzare la finestra di dialogo di arresto imprevisto. È necessario usare S, D o S e D.

 

L'ordine in cui vengono usati i flag non è importante. Ad esempio, CSP indica un arresto pianificato in cui viene visualizzata la finestra di dialogo di arresto previsto e è necessario un commento.

Nnn

Motivo principale. Questo componente deve essere un numero compreso nell'intervallo da 64 a 255. L'intervallo 0-63 è riservato per l'uso da parte del sistema.

nnnnn

Motivo secondario. Questo componente deve essere compreso nell'intervallo 0-65535.

I motivi personalizzati vengono ordinati nell'interfaccia utente in base al numero motivo principale, quindi in base al numero motivo secondario. Nessun motivo personalizzato può usare gli stessi motivi principali e secondari, a meno che non ne sia pianificato uno e l'altro non sia pianificato. In caso contrario, il sistema userà la prima istanza e ignorerà gli altri.

I dati per ogni valore del Registro di sistema sono due stringhe separate da \n\r. La prima stringa è una stringa del titolo da visualizzare nella finestra di dialogo di arresto e scritta nel registro eventi. La dimensione massima è di 64 caratteri. Le stringhe del titolo devono essere univoche. I titoli personalizzati non possono corrispondere ai titoli standard definiti dal sistema o a un altro titolo personalizzato. La seconda stringa è una stringa di descrizione da visualizzare nella finestra di dialogo di arresto; è facoltativo. La dimensione massima è di 256 caratteri.

Requisiti