Função de retorno de chamada SENDASYNCPROC (winuser.h)

2025-10-02

Uma função de retorno de chamada definida pelo aplicativo usada com a função SendMessageCallback . O sistema passa a mensagem para a função de retorno de chamada depois de passar a mensagem para o procedimento da janela de destino. O tipo SENDASYNCPROC define um ponteiro para essa função de retorno de chamada. SendAsyncProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

SENDASYNCPROC Sendasyncproc;

VOID Sendasyncproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  ULONG_PTR unnamedParam3,
  LRESULT unnamedParam4
)
{...}

Parâmetros

unnamedParam1

Tipo: HWND

Um identificador para a janela cujo procedimento de janela recebeu a mensagem. Esse parâmetro normalmente é chamado de hWnd.

Se a função SendMessageCallback tiver sido chamada com seu parâmetro hWnd definido como HWND_BROADCAST, o sistema chamará a função SendAsyncProc uma vez para cada janela de nível superior.

unnamedParam2

Tipo: UINT

A mensagem. Esse parâmetro normalmente é chamado de uMsg.

unnamedParam3

Tipo: ULONG_PTR

Um valor definido pelo aplicativo enviado da função SendMessageCallback . Esse parâmetro normalmente é chamado de dwData.

unnamedParam4

Tipo: LRESULT

O resultado do processamento da mensagem. Esse valor depende da mensagem. Esse parâmetro normalmente é chamado de lResult.

Valor de retorno

None

Observações

Observação

Os parâmetros são definidos no cabeçalho sem nomes: typedef VOID (CALLBACK* SENDASYNCPROC)(HWND, UINT, ULONG_PTR, LRESULT);. Portanto, o bloco de sintaxe os lista como unnamedParam1 - unnamedParam4. Você pode nomear esses parâmetros em seu aplicativo. No entanto, eles geralmente são nomeados conforme mostrado nas descrições de parâmetro.

Instale uma função de retorno de chamada definida pelo aplicativo SendAsyncProc passando um ponteiro SENDASYNCPROC para a função SendMessageCallback .

A função de retorno de chamada só é chamada quando o thread chamado SendMessageCallback chama GetMessage, PeekMessage ou WaitMessage.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
Header	winuser.h (inclua Windows.h)