Funzione ShutdownBlockReasonCreate (winuser.h)

Indica che il sistema non può essere arrestato e imposta una stringa motivo da visualizzare all'utente se viene avviato l'arresto del sistema.

Sintassi

BOOL ShutdownBlockReasonCreate(
  [in] HWND    hWnd,
  [in] LPCWSTR pwszReason
);

Parametri

[in] hWnd

Handle alla finestra principale dell'applicazione.

[in] pwszReason

Il motivo per cui l'applicazione deve bloccare l'arresto del sistema. Questa stringa verrà troncata a scopo di visualizzazione dopo MAX_STR_BLOCKREASON caratteri.

Valore restituito

Se la chiamata ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

Questa funzione può essere chiamata solo dal thread che ha creato la finestra specificata dal parametro hWnd . In caso contrario, la funzione ha esito negativo e l'ultimo codice di errore è ERROR_ACCESS_DENIED.

Le applicazioni devono chiamare questa funzione quando iniziano un'operazione che non può essere interrotta, ad esempio la combustione di un CD o DVD. Al termine dell'operazione, chiamare la funzione ShutdownBlockReasonDestroy per indicare che il sistema può essere arrestato.

Poiché gli utenti sono in genere in fretta quando si arresta il sistema, possono trascorrere solo pochi secondi esaminando i motivi di arresto visualizzati dal sistema. È quindi importante che le stringhe di motivo siano brevi e chiare. Ad esempio, "La burn di CD è in corso." è migliore di "Questa applicazione blocca l'arresto del sistema perché una burn CD è in corso. Non arrestare."

Requisiti

Vedi anche

ShutdownBlockReasonDestroy

Arresto