RegisterWindowMessageA, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Messages et files d’attente de messages
Référence