PostThreadMessageA, fonction (winuser.h)

Article
05/20/2023

Publie un message dans la file d’attente de messages du thread spécifié. Il retourne sans attendre que le thread traite le message.

Syntaxe

BOOL PostThreadMessageA(
  [in] DWORD  idThread,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Paramètres

[in] idThread

Type : DWORD

Identificateur du thread sur lequel le message doit être publié.

La fonction échoue si le thread spécifié n’a pas de file d’attente de messages. Le système crée la file d’attente de messages d’un thread lorsque le thread effectue son premier appel à l’une des fonctions User ou GDI. Pour plus d'informations, consultez la section Notes.

La publication de messages est soumise à l’UIPI. Le thread d’un processus peut publier des messages uniquement dans des files d’attente de messages publiés de threads dans des processus de niveau d’intégrité inférieur ou égal.

Ce thread doit avoir le privilège SE_TCB_NAME pour publier un message sur un thread qui appartient à un processus avec le même identificateur unique local (LUID), mais qui se trouve sur un autre bureau. Sinon, la fonction échoue et retourne ERROR_INVALID_THREAD_ID.

Ce thread doit appartenir au même bureau que le thread appelant ou à un processus avec le même LUID. Sinon, la fonction échoue et retourne ERROR_INVALID_THREAD_ID.

[in] Msg

Type : UINT

Type de message à publier.

[in] wParam

Type : WPARAM

Informations supplémentaires spécifiques au message.

[in] lParam

Type : LPARAM

Informations supplémentaires spécifiques au message.

Valeur renvoyé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. GetLastError retourne ERROR_INVALID_THREAD_ID si idThread n’est pas un identificateur de thread valide ou si le thread spécifié par idThread n’a pas de file d’attente de messages. GetLastError retourne ERROR_NOT_ENOUGH_QUOTA lorsque la limite de message est atteinte.

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é).

Le thread sur lequel le message est publié doit avoir créé une file d’attente de messages, sinon l’appel à PostThreadMessage échoue. Utilisez la méthode suivante pour gérer cette situation.

Créez un objet d’événement, puis créez le thread.
Utilisez la fonction WaitForSingleObject pour attendre que l’événement soit défini sur l’état signalé avant d’appeler PostThreadMessage.
Dans le thread dans lequel le message sera publié, appelez PeekMessage comme illustré ici pour forcer le système à créer la file d’attente des messages.
PeekMessage(&msg, NULL, WM_USER, WM_USER, PM_NOREMOVE)
Définissez l’événement pour indiquer que le thread est prêt à recevoir des messages publiés.

Le thread sur lequel le message est publié récupère le message en appelant la fonction GetMessage ou PeekMessage . Le membre hwnd de la structure MSG retournée est NULL.

Les messages publiés par PostThreadMessage ne sont pas associés à une fenêtre. En règle générale, les messages qui ne sont pas associés à une fenêtre ne peuvent pas être distribués par la fonction DispatchMessage . Par conséquent, si le thread destinataire se trouve dans une boucle modale (comme utilisé par MessageBox ou DialogBox), les messages seront perdus. Pour intercepter des messages de thread dans une boucle modale, utilisez un hook spécifique au thread.

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é.

Il existe une limite de 10 000 messages publiés par file d’attente de 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

La valeur minimale acceptable est 4000.

Notes

L’en-tête winuser.h définit PostThreadMessage 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


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)