Partager via


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

Obtient un message de la file d’attente de messages et retourne si aucun message n’est obtenu. Il s’agit de la version ANSI de cette méthode.

Syntaxe

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

Paramètres

[out] pMsg

Pointeur vers une structure MSG qui reçoit des données de message.

[in] hwnd

Gérez la fenêtre dont les messages sont obtenus. La fenêtre doit appartenir au thread actuel. Si cette valeur est NULL, cette méthode obtient des messages pour n’importe quelle fenêtre appartenant au thread appelant.

[in] wMsgFilterMin

Spécifie la valeur de message la plus basse à obtenir.

[in] wMsgFilterMax

Spécifie la valeur de message la plus élevée à obtenir.

[in] wRemoveMsg

Spécifie comment les messages sont gérés. Pour plus d’informations, consultez la fonction PeekMessage .

[out] pfResult

Pointeur vers un boOL qui reçoit la valeur de retour de la fonction PeekMessage .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur Description
S_OK
La méthode a réussi.
E_INVALIDARG
Un ou plusieurs paramètres ne sont pas valides.

Remarques

Si wMsgFilterMin et wMsgFilterMax sont tous deux zéro, cette méthode retourne tous les messages disponibles ; autrement dit, aucun filtrage de plage n’est effectué.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête msctf.h
DLL Msctf.dll
Composant redistribuable TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfMessagePump

MSG

PeekMessage