PostMessageA, fonction (winuser.h)

Article
03/04/2024

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
HWND_BROADCAST ((HWND)0xffff)	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.
NULL	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)