WM_DDE_INITIATE message

Une application cliente DDE (Dynamic Data Exchange) envoie un message WM_DDE_INITIATE pour lancer une conversation avec une application serveur répondant aux noms d’application et de rubrique spécifiés. À la réception de ce message, toutes les applications serveur avec des noms qui correspondent à l’application spécifiée et qui prennent en charge la rubrique spécifiée sont censées l’accuser réception. (Pour plus d’informations, consultez le message WM_DDE_ACK .)

#define WM_DDE_INITIATE        0x03E0

Paramètres

wParam

Handle de la fenêtre cliente qui envoie le message.

lParam

Le mot de bas ordre contient un atome qui identifie l’application avec laquelle une conversation est demandée. Le nom de l’application ne peut pas contenir de barres obliques (/) ou de barres obliques inverses (\). Ces caractères sont réservés aux implémentations réseau. Si ce paramètre a la valeur NULL, une conversation avec toutes les applications est demandée.

Le mot d’ordre élevé contient un atome qui identifie la rubrique pour laquelle une conversation est demandée. Si la rubrique a la valeur NULL, des conversations pour toutes les rubriques disponibles sont demandées.

Notes

Si le mot de bas ordre de lParam est NULL, n’importe quelle application serveur peut répondre. Si le mot d’ordre supérieur de lParam est NULL, toute rubrique est valide. À la réception d’une demande de WM_DDE_INITIATE avec le mot d’ordre élevé du paramètre lParam défini sur NULL, un serveur doit envoyer un message WM_DDE_ACK pour chacune des rubriques qu’il prend en charge.

Envoi

Le client diffuse le message dans toutes les fenêtres de niveau supérieur en définissant le premier paramètre de SendMessagesur HWND_BROADCAST.

Si l’application cliente a déjà obtenu le handle de fenêtre du serveur souhaité, elle peut envoyer WM_DDE_INITIATE directement à la fenêtre serveur en passant le handle de fenêtre du serveur comme premier paramètre de SendMessage.

L’application cliente alloue des atomes en appelant la fonction GlobalAddAtom .

Lorsque SendMessage retourne, l’application cliente doit supprimer les atomes.

Réception

Pour terminer l’initiation d’une conversation, l’application serveur doit répondre avec un ou plusieurs messages WM_DDE_ACK , chaque message étant destiné à une rubrique distincte. Lors de l’envoi de WM_DDE_ACK message, le serveur doit créer de nouveaux atomes ; il ne doit pas réutiliser les atomes envoyés avec WM_DDE_INITIATE.

Spécifications

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]
En-tête	Dde.h (inclure Windows.h)

Voir aussi

Référence

GlobalAddAtom

PostMessage

SendMessage

WM_DDE_ACK

Conceptuel

À propos de Dynamic Data Exchange