Função ShutdownBlockReasonCreate (winuser.h)

  • Artigo

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)

Confira também

ShutdownBlockReasonDestroy

Desligar