Função ShutdownBlockReasonCreate (winuser.h)
Indica que o sistema não pode ser desligado e define uma cadeia de caracteres de motivo a ser exibida para o usuário se o desligamento do sistema for iniciado.
Sintaxe
BOOL ShutdownBlockReasonCreate(
[in] HWND hWnd,
[in] LPCWSTR pwszReason
);
Parâmetros
[in] hWnd
Um identificador para a janela main do aplicativo.
[in] pwszReason
O motivo pelo qual o aplicativo deve bloquear o desligamento do sistema. Essa cadeia de caracteres será truncada para fins de exibição após MAX_STR_BLOCKREASON caracteres.
Retornar valor
Se a chamada for bem-sucedida, o valor retornado será diferente de zero.
Se a chamada falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Essa função só pode ser chamada do thread que criou a janela especificada pelo parâmetro hWnd . Caso contrário, a função falhará e o último código de erro será ERROR_ACCESS_DENIED.
Os aplicativos devem chamar essa função à medida que iniciam uma operação que não pode ser interrompida, como a queima de um CD ou DVD. Quando a operação for concluída, chame a função ShutdownBlockReasonDestroy para indicar que o sistema pode ser desligado.
Como os usuários normalmente têm pressa ao desligar o sistema, eles podem passar apenas alguns segundos examinando os motivos de desligamento exibidos pelo sistema. Portanto, é importante que suas cadeias de caracteres de motivo sejam curtas e claras. Por exemplo, "Uma gravação de CD está em andamento". é melhor do que "Este aplicativo está bloqueando o desligamento do sistema porque uma gravação de CD está em andamento. Não desligue."
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-misc-l1-1-0 (introduzido em Windows 8) |