SendMessageCallbackW, fonction (winuser.h)
Envoie le message spécifié à une fenêtre ou à une fenêtre. Elle appelle la procédure de fenêtre pour la fenêtre spécifiée et retourne immédiatement si la fenêtre appartient à un autre thread. Une fois que la procédure de fenêtre traite le message, le système appelle la fonction de rappel spécifiée, en passant le résultat du traitement du message et une valeur définie par l’application à la fonction de rappel.
Syntaxe
BOOL SendMessageCallbackW(
[in] HWND hWnd,
[in] UINT Msg,
[in] WPARAM wParam,
[in] LPARAM lParam,
[in] SENDASYNCPROC lpResultCallBack,
[in] ULONG_PTR dwData
);
Paramètres
[in] hWnd
Type : HWND
Handle vers la fenêtre dont la procédure de fenêtre reçoit le message. Si ce paramètre est HWND_BROADCAST ((HWND)0xffff), le message est envoyé à toutes les fenêtres de niveau supérieur du système, y compris les fenêtres désactivées ou invisibles, les fenêtres superposées et les fenêtres contextuelles ; mais le message n’est pas envoyé aux fenêtres enfants.
[in] Msg
Type : uiNT
Message à envoyer.
Pour obtenir des listes des messages fournis par le système, consultez System-Defined Messages.
[in] wParam
Type : WPARAM
Informations supplémentaires spécifiques aux messages.
[in] lParam
Type : LPARAM
Informations supplémentaires spécifiques aux messages.
[in] lpResultCallBack
Type : SENDASYNCPROC
Pointeur vers une fonction de rappel que le système appelle après la procédure de fenêtre traite le message. Pour plus d’informations, consultez SendAsyncProc.
Si hWnd est HWND_BROADCAST ((HWND)0xffff), le système appelle la fonction de rappel SendAsyncProc une fois pour chaque fenêtre de niveau supérieur.
[in] dwData
Type : ULONG_PTR
Valeur définie par l’application à envoyer à la fonction de rappel pointée par le paramètre lpCallBack.
Valeur de retour
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Si la fenêtre cible appartient au même thread que l’appelant, la procédure de fenêtre est appelée de façon synchrone et la fonction de rappel est appelée immédiatement après la retour de la procédure de fenêtre. Si la fenêtre cible appartient à un thread différent de l’appelant, la fonction de rappel est appelée uniquement lorsque le thread appelé SendMessageCallback appelle également GetMessage, PeekMessageou WaitMessage.
Si vous envoyez un message dans la plage ci-dessous WM_USER aux fonctions de message asynchrones (postMessage, SendNotifyMessageet SendMessageCallback), ses paramètres de message ne peuvent pas inclure de pointeurs. Sinon, l’opération échoue. Les fonctions retournent avant que le thread de réception ait eu la possibilité de traiter le message et l’expéditeur libère la mémoire avant son utilisation.
Les applications qui doivent communiquer à l’aide de HWND_BROADCAST doivent utiliser la fonction RegisterWindowMessage pour obtenir un message unique pour la communication entre applications.
Le système effectue uniquement le marshaling pour les messages système (ceux de la plage 0 à (WM_USER-1)). Pour envoyer d’autres messages (ces >= WM_USER) à un autre processus, vous devez effectuer un marshaling personnalisé.
Note
L’en-tête winuser.h définit SendMessageCallback comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include Windows.h) |
| bibliothèque | User32.lib |
| DLL | User32.dll |
| ensemble d’API | ext-ms-win-ntuser-message-l1-1-0 (introduit dans Windows 8) |
Voir aussi
conceptuelle
messages et files d’attente de messages
de référence