Fonction RegisterWindowMessageW (winuser.h)

Définit un nouveau message de fenêtre qui est garanti comme 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 RegisterWindowMessageW(
  [in] LPCWSTR lpString
);

Paramètres

[in] lpString

Type : LPCTSTR

Message à inscrire.

Valeur retournée

Type : UINT

Si le message est correctement inscrit, la valeur renvoyée est un identificateur de message dans la plage 0xC000 à 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 coopérantes.

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 RegisterWindowMessage uniquement 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 d’une classe de fenêtre, et non d’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 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)

Voir aussi

Conceptuel

Messages et files d’attente de messages

PostMessage

Référence

SendMessage