WM_DDE_INITIATE Nachricht

Eine DDE-Clientanwendung (Dynamic Data Exchange) sendet eine WM_DDE_INITIATE-Nachricht , um eine Konversation mit einer Serveranwendung zu initiieren, die auf die angegebenen Anwendungs- und Themennamen reagiert. Nach Dem Empfang dieser Meldung wird erwartet, dass alle Serveranwendungen mit Namen, die mit der angegebenen Anwendung übereinstimmen und das angegebene Thema unterstützen, diese bestätigen. (Weitere Informationen finden Sie in der meldung WM_DDE_ACK .)

#define WM_DDE_INITIATE        0x03E0

Parameter

wParam

Ein Handle an das Clientfenster, das die Nachricht sendet.

lParam

Das Wort mit niedriger Reihenfolge enthält ein Atom, das die Anwendung identifiziert, mit der eine Konversation angefordert wird. Der Anwendungsname darf keine Schrägstriche (/) oder umgekehrte Schrägstriche (\) enthalten. Diese Zeichen sind für Netzwerkimplementierungen reserviert. Wenn dieser Parameter NULL ist, wird eine Konversation mit allen Anwendungen angefordert.

Das Wort mit hoher Ordnung enthält ein Atom, das das Thema identifiziert, für das eine Konversation angefordert wird. Wenn das Thema NULL ist, werden Unterhaltungen für alle verfügbaren Themen angefordert.

Bemerkungen

Wenn das Wort mit niedriger Ordnung von lParamNULL ist, kann jede Serveranwendung antworten. Wenn das Wort mit hoher Ordnung von lParamNULL ist, ist jedes Thema gültig. Beim Empfang einer WM_DDE_INITIATE-Anforderung mit dem Wort mit hoher Ordnung des lParam-Parameters , der auf NULL festgelegt ist, muss ein Server für jedes der unterstützten Themen eine WM_DDE_ACK Nachricht senden.

Senden

Der Client sendet die Nachricht an alle Fenster der obersten Ebene, indem der erste Parameter von SendMessage auf HWND_BROADCAST festgelegt wird.

Wenn die Clientanwendung bereits das Fensterhandle des gewünschten Servers abgerufen hat, kann sie WM_DDE_INITIATE direkt an das Serverfenster senden, indem sie das Fensterhandle des Servers als ersten Parameter von SendMessage übergibt.

Die Clientanwendung ordnet Atome zu, indem die GlobalAddAtom-Funktion aufgerufen wird.

Wenn SendMessage zurückgibt, muss die Clientanwendung die Atome löschen.

Empfangen

Um die Initiierung einer Unterhaltung abzuschließen, muss die Serveranwendung mit einer oder mehreren WM_DDE_ACK Nachrichten antworten, wobei jede Nachricht für ein separates Thema steht. Beim Senden WM_DDE_ACK Nachricht sollte der Server neue Atome erstellen. Die Atome, die mit WM_DDE_INITIATE gesendet werden, sollten nicht wiederverwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Dde.h (windows.h einschließen)

Siehe auch

Referenz

GlobalAddAtom

PostMessage

SendMessage

WM_DDE_ACK

Konzept

Informationen zum dynamischen Datenaustausch