Função PostQuitMessage (winuser.h)

Artigo
03/04/2024

Indica ao sistema que um thread fez uma solicitação para terminar (sair). Normalmente, ele é usado em resposta a uma mensagem de WM_DESTROY .

Sintaxe

void PostQuitMessage(
  [in] int nExitCode
);

Parâmetros

[in] nExitCode

Tipo: int

O código de saída do aplicativo. Esse valor é usado como o parâmetro wParam da mensagem WM_QUIT .

Retornar valor

Nenhum

Comentários

A função PostQuitMessage posta uma mensagem WM_QUIT na fila de mensagens do thread e retorna imediatamente; a função simplesmente indica ao sistema que o thread está solicitando a desistência em algum momento no futuro.

Quando o thread recupera a mensagem WM_QUIT de sua fila de mensagens, ele deve sair do loop de mensagens e retornar o controle para o sistema. O valor de saída retornado ao sistema deve ser o parâmetro wParam da mensagem WM_QUIT .

Exemplos

Para obter um exemplo, consulte Postando uma mensagem.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-message-l1-1-0 (introduzido no Windows 8)