Méthode ISimpleFrameSite ::P reMessageFilter (ocidl.h)

Article
02/29/2024

Fournit à un site la possibilité de traiter un message reçu par la fenêtre d’un contrôle avant que le contrôle lui-même effectue un traitement.

Syntaxe

HRESULT PreMessageFilter(
  [in]  HWND    hWnd,
  [in]  UINT    msg,
  [in]  WPARAM  wp,
  [in]  LPARAM  lp,
  [out] LRESULT *plResult,
  [out] DWORD   *pdwCookie
);

Paramètres

[in] hWnd

Handle de la fenêtre de contrôle recevant le message.

[in] msg

Message reçu par le site frame simple.

[in] wp

WPARAM du message.

[in] lp

LPARAM du message.

[out] plResult

Pointeur vers la variable qui reçoit le résultat du traitement du message.

[out] pdwCookie

Pointeur vers la variable qui sera passée à ISimpleFrameSite ::P ostMessageFilter si elle est appelée ultérieurement. Ce paramètre ne doit contenir des données allouées que si cette méthode retourne S_OK afin qu’elle reçoive également un appel à PostMessageFilter qui peut libérer l’allocation. L’appelant n’est en aucun cas responsable de tout ce qui est retourné dans ce paramètre.

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Code de retour	Description
S_OK	Le site de trame simple n’utilise pas le message dans ce filtre afin que davantage de traitement puisse avoir lieu.
S_FALSE	Le site a traité le message et aucun traitement supplémentaire ne doit se produire.
E_NOTIMPL	Le site n’effectue aucun filtrage des messages, ce qui indique que PostMessageFilter n’a pas besoin d’être appelé ultérieurement.
E_POINTER	L’adresse dans plResult ou pdwCookie n’est pas valide.

Remarques

Les valeurs de retour réussies indiquent si le site souhaite autoriser un traitement ultérieur. S_OK indique un traitement ultérieur, tandis que S_FALSE moyens ne traitent pas davantage. S_OK indique également que le contrôle doit appeler ultérieurement PostMessageFilter.

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	ocidl.h

Voir aussi

ISimpleFrameSite

Partager via