RegisterWindowMessageA, fonction (winuser.h)

Article
03/13/2024

Définit un nouveau message de fenêtre qui est garanti comme étant unique dans l’ensemble du système. La valeur du message peut être utilisée lors de l’envoi ou de la publication de messages.

Syntaxe

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

Paramètres

[in] lpString

Type : LPCTSTR

Message à inscrire.

Valeur retournée

Type : UINT

Si le message est correctement enregistré, la valeur de retour est un identificateur de message dans la plage 0xC000 jusqu’à 0xFFFF.

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

La fonction RegisterWindowMessage est généralement utilisée pour inscrire des messages pour la communication entre deux applications qui coopèrent.

Si deux applications différentes inscrivent la même chaîne de message, les applications retournent la même valeur de message. Le message reste inscrit jusqu’à la fin de la session.

Utilisez Uniquement RegisterWindowMessage lorsque plusieurs applications doivent traiter le même message. Pour envoyer des messages privés dans une classe de fenêtre, une application peut utiliser n’importe quel entier de la plage WM_USER via 0x7FFF. (Les messages de cette plage sont privés à une classe de fenêtre, et non à une application. Par exemple, les classes de contrôle prédéfinies telles que BUTTON, EDIT, LISTBOX et COMBOBOX peuvent utiliser des valeurs dans cette plage.)

Exemples

Pour obtenir un exemple, consultez Recherche de texte.

Notes

L’en-tête winuser.h définit RegisterWindowMessage en tant qu’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. La combinaison 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)