Compartilhar via


Função PostQuitMessage (winuser.h)

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)

Confira também

Conceitual

GetMessage

Mensagens e filas de mensagens

PeekMessage

PostMessage

Referência

WM_DESTROY

WM_QUIT