Condividi tramite


Metodo ITfMessagePump::P eekMessageA (msctf.h)

Ottiene un messaggio dalla coda del messaggio e restituisce se non viene ottenuto alcun messaggio. Si tratta della versione ANSI di questo metodo.

Sintassi

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

Parametri

[out] pMsg

Puntatore a una struttura MSG che riceve i dati dei messaggi.

[in] hwnd

Gestire nella finestra i cui messaggi vengono ottenuti. La finestra deve appartenere al thread corrente. Se questo valore è NULL, questo metodo ottiene messaggi per qualsiasi finestra di proprietà del thread chiamante.

[in] wMsgFilterMin

Specifica il valore del messaggio più basso da ottenere.

[in] wMsgFilterMax

Specifica il valore di messaggio più alto da ottenere.

[in] wRemoveMsg

Specifica il modo in cui vengono gestiti i messaggi. Per altre informazioni, vedere la funzione PeekMessage .

[out] pfResult

Puntatore a un valore BOOL che riceve il valore restituito dalla funzione PeekMessage .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_INVALIDARG
Uno o più parametri non sono validi.

Commenti

Se wMsgFilterMin e wMsgFilterMax sono entrambi zero, questo metodo restituisce tutti i messaggi disponibili; ovvero, non viene eseguito alcun filtro dell'intervallo.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione msctf.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfMessagePump

MSG

PeekMessage