PostMessageA, fonction (winuser.h)
Places (publications) un message dans la file d’attente de messages associée au thread qui a créé la fenêtre spécifiée et retourne sans attendre que le thread traite le message.
Pour publier un message dans la file d’attente de messages associée à un thread, utilisez la fonction PostThreadMessage .
Syntaxe
BOOL PostMessageA(
[in, optional] HWND hWnd,
[in] UINT Msg,
[in] WPARAM wParam,
[in] LPARAM lParam
);
Paramètres
[in, optional] hWnd
Type : HWND
Handle de la fenêtre dont la procédure de fenêtre consiste à recevoir le message. Les valeurs suivantes ont des significations spéciales.
| Valeur | Signification |
|---|---|
|
Le message est publié dans toutes les fenêtres de niveau supérieur du système, y compris les fenêtres désactivées ou invisibles, les fenêtres qui se chevauchent et les fenêtres contextuelles. Le message n’est pas publié dans les fenêtres enfants. |
|
La fonction se comporte comme un appel à PostThreadMessage avec le paramètre dwThreadId défini sur l’identificateur du thread actif. |
À compter de Windows Vista, la publication de messages est soumise à UIPI. Le thread d’un processus peut publier des messages uniquement dans des files d’attente de messages de threads dans des processus de niveau d’intégrité inférieur ou égal.
[in] Msg
Type : UINT
Message à publier.
Pour obtenir la liste des messages fournis par le système, consultez Messages définis par le système.
[in] wParam
Type : WPARAM
Informations supplémentaires spécifiques au message.
[in] lParam
Type : LPARAM
Informations supplémentaires spécifiques au message.
Valeur retournée
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étaillées sur l’erreur, appelez GetLastError.
Remarques
Lorsqu’un message est bloqué par UIPI, la dernière erreur, récupérée avec GetLastError, est définie sur 5 (accès refusé).
Les messages d’une file d’attente de messages sont récupérés par des appels à la fonction GetMessage ou PeekMessage .
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 (ceux >= WM_USER) à un autre processus, vous devez effectuer un marshaling personnalisé.
Si vous envoyez un message dans la plage ci-dessous WM_USER aux fonctions de message asynchrones (PostMessage, SendNotifyMessage et 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 n’ait eu la possibilité de traiter le message et que l’expéditeur libère la mémoire avant d’être utilisé.
Ne publiez pas le message WM_QUIT à l’aidede PostMessage ; utilisez la fonction PostQuitMessage .
Une application d’accessibilité peut utiliser PostMessage pour publier des messages WM_APPCOMMAND dans l’interpréteur de commandes pour lancer des applications. Il n’est pas garanti que cette fonctionnalité fonctionne pour d’autres types d’applications.
Une file d’attente de messages peut contenir au maximum 10 000 messages. Cette limite doit être suffisamment importante. Si votre application dépasse la limite, elle doit être repensée pour éviter de consommer autant de ressources système. Pour ajuster cette limite, modifiez la clé de Registre suivante.
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows NT CurrentVersion Windows USERPostMessageLimit
Si la fonction échoue, appelez GetLastError pour obtenir des informations d’erreur étendues. GetLastError retourne ERROR_NOT_ENOUGH_QUOTA lorsque la limite est atteinte.
La valeur minimale acceptable est 4000.
Exemples
L’exemple suivant montre comment publier un message de fenêtre privée à l’aide de la fonction PostMessage . Supposons que vous avez défini un message de fenêtre privée appelé WM_COMPLETE :
#define WM_COMPLETE (WM_USER + 0)
Vous pouvez publier un message dans la file d’attente de messages associée au thread qui a créé la fenêtre spécifiée, comme indiqué ci-dessous :
WaitForSingleObject (pparams->hEvent, INFINITE) ;
lTime = GetCurrentTime () ;
PostMessage (pparams->hwnd, WM_COMPLETE, 0, lTime);
Pour plus d’exemples, consultez Lancement d’une liaison de données.
Notes
L’en-tête winuser.h définit PostMessage comme un 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.
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 | winuser.h (inclure 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
Conceptuel
Messages et files d’attente de messages
Référence