Méthode ISimpleFrameSite ::P reMessageFilter (ocidl.h)
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.
HRESULT PreMessageFilter(
[in] HWND hWnd,
[in] UINT msg,
[in] WPARAM wp,
[in] LPARAM lp,
[out] LRESULT *plResult,
[out] DWORD *pdwCookie
);
[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.
Cette méthode peut retourner les valeurs suivantes.
Code de retour | Description |
---|---|
|
Le site de trame simple n’utilise pas le message dans ce filtre afin que davantage de traitement puisse avoir lieu. |
|
Le site a traité le message et aucun traitement supplémentaire ne doit se produire. |
|
Le site n’effectue aucun filtrage des messages, ce qui indique que PostMessageFilter n’a pas besoin d’être appelé ultérieurement. |
|
L’adresse dans plResult ou pdwCookie n’est pas valide. |
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.
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 |