PostThreadMessage

A função PostThreadMessage coloca (postagens) uma mensagem da fila de mensagem do thread especificado e, em seguida, retorna sem esperar que o segmento ao processo de mensagem.

(BOOL PostThreadMessage DWORD  idThread, / / thread identificadorUINTMsg, / / mensagens para postarWPARAMwParam, / / primeiro parâmetro da mensagemLPARAMlParam / / segundo parâmetro message);
 

Parâmetros

idThread

Identificador de thread do thread para o qual a mensagem será postada.

A função falhará se o thread especificado não tem uma fila de mensagens. O sistema cria fila de mensagens do segmento quando o segmento faz sua primeira chamada para uma das funções de usuário Win32 ou GDI. Para obter mais informações, consulte a seção Comentários.

Msg

Especifica o tipo de mensagem a ser lançado.

wParam

Especifica informações message-specific adicionais.

lParam

Especifica informações message-specific adicionais.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError. GetLastError Retorna ERROR_INVALID_THREAD_ID se idThread não é um identificador válido do thread, ou se o thread especificado por idThread não tem uma fila de mensagens.

Observações

O segmento ao qual a mensagem está lançada deve ter criado uma fila de mensagens, ou então a chamada para PostThreadMessage falhar. Use um dos seguintes métodos para lidar com essa situação:

• Chame PostThreadMessage. Se ele falhar, chame o função Sleep e chamada PostThreadMessage novamente. Repetir até PostThreadMessage êxito.
• Criar um objeto de evento e, em seguida, criar o thread. Uso o WaitForSingleObject função para aguardar o evento a ser definido como o sinalizado estado antes de chamar PostThreadMessage. No segmento ao qual a mensagem será postada, chame PeekMessage(amp; msg, NULL, WM_USER, WM_USER, PM_NOREMOVE) para forçar o sistema para criar a fila de mensagem. Defina o evento, para indicar que o thread está pronto para receber mensagens postadas.

O segmento ao qual a mensagem está lançada recupera a mensagem chamando a função GetMessage ou PeekMessage . O hwnd membro do retornado MSG estrutura é NULL.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Mensagens e visão geral de filas de mensagem, mensagem e funções de fila de mensagem, GetCurrentThreadId, GetMessage, GetWindowThreadProcessId, MSG, PeekMessage, PostMessage, dormir, WaitForSingleObject