Partilhar via


Método ITfMessagePump::P eekMessageW (msctf.h)

Obtém uma mensagem da fila de mensagens e retorna se nenhuma mensagem é obtida. Esta é a versão Unicode desse método.

Sintaxe

HRESULT PeekMessageW(
  [out] LPMSG pMsg,
  [in]  HWND  hwnd,
  [in]  UINT  wMsgFilterMin,
  [in]  UINT  wMsgFilterMax,
  [in]  UINT  wRemoveMsg,
  [out] BOOL  *pfResult
);

Parâmetros

[out] pMsg

Ponteiro para uma estrutura MSG que recebe dados de mensagem.

[in] hwnd

Manipule para a janela cujas mensagens são obtidas. A janela deve pertencer ao thread atual. Se esse valor for NULL, esse método obterá mensagens para qualquer janela que pertença ao thread de chamada.

[in] wMsgFilterMin

Especifica o valor de mensagem mais baixo a ser obtido.

[in] wMsgFilterMax

Especifica o valor de mensagem mais alto a ser obtido.

[in] wRemoveMsg

Especifica como as mensagens são tratadas. Para obter mais informações, consulte a função PeekMessage .

[out] pfResult

Ponteiro para um BOOL que recebe o valor retornado da função PeekMessage .

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
E_INVALIDARG
Um ou mais parâmetros são inválidos.

Comentários

Se wMsgFilterMin e wMsgFilterMax forem zero, esse método retornará todas as mensagens disponíveis; ou seja, nenhuma filtragem de intervalo é executada.

Requisitos

   
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 msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

ITfMessagePump

MSG

PeekMessage