Share via


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

Obtiene un mensaje de la cola de mensajes y devuelve si no se obtiene ningún mensaje. Esta es la versión ANSI de este método.

Sintaxis

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

Parámetros

[out] pMsg

Puntero a una estructura MSG que recibe datos del mensaje.

[in] hwnd

Identificador de la ventana cuyos mensajes se obtienen. La ventana debe pertenecer al subproceso actual. Si este valor es NULL, este método obtiene los mensajes de cualquier ventana propiedad del subproceso que realiza la llamada.

[in] wMsgFilterMin

Especifica el valor de mensaje más bajo que se va a obtener.

[in] wMsgFilterMax

Especifica el valor de mensaje más alto que se va a obtener.

[in] wRemoveMsg

Especifica cómo se controlan los mensajes. Para obtener más información, consulte la función PeekMessage .

[out] pfResult

Puntero a un BOOL que recibe el valor devuelto de la función PeekMessage .

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
Método realizado correctamente.
E_INVALIDARG
Uno o varios parámetros no son válidos.

Comentarios

Si wMsgFilterMin y wMsgFilterMax son cero, este método devuelve todos los mensajes disponibles; es decir, no se realiza ningún filtrado de intervalos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado msctf.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

ITfMessagePump

MSG

PeekMessage