Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Définit un nouveau message de fenêtre qui est garanti être unique dans tout le 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 de retour
Type : uiNT
Si le message est correctement inscrit, la valeur de retour est un identificateur de message dans la plage 0xC000 via 0xFFFF.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
La fonction RegisterWindowMessage est généralement utilisée pour inscrire des messages pour communiquer entre deux applications de coopération.
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’à ce que la session se termine.
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 dans la plage WM_USER via 0x7FFF. (Les messages de cette plage sont privés dans une classe de fenêtre, et non dans une application. Par exemple, des classes de contrôle prédéfinies telles que BUTTON, EDIT, LISTBOXet COMBOBOX peuvent utiliser des valeurs dans cette plage.)
Exemples
Pour obtenir un exemple, consultez recherche de texte.
Note
L’en-tête winuser.h définit RegisterWindowMessage comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include 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
conceptuelle
messages et files d’attente de messages
de référence