XTYP _ WILDCONNECT-Transaktion

Ermöglicht es einem Client, eine Konversation für jedes der Paare aus Dienstname und Themenname des Servers herzustellen, die mit dem angegebenen Dienst- und Themennamen übereinstimmen. Eine DDE-Serverrückruffunktion (dynamische Daten Exchange), DdeCallback,empfängt diese Transaktion, wenn ein Client einen NULL-Dienstnamen, einen NULL-Themennamen oder beides in einem Aufruf der DdeConnect- oder DdeConnectList-Funktion angibt.

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_WILDCONNECT        (0x00E0 | XCLASS_DATA | XTYPF_NOBLOCK)

Parameter

uType

Der Transaktionstyp:

uFmt

Wird nicht verwendet.

hconv

Wird nicht verwendet.

hsz1

Ein Handle für den Themennamen. Wenn dieser Parameter NULL ist, fordert der Client eine Konversation für alle Vom Server unterstützten Themennamen an.

hsz2

Ein Handle für den Dienstnamen. Wenn dieser Parameter NULL ist, fordert der Client eine Konversation für alle Vom Server unterstützten Dienstnamen an.

hdata

Wird nicht verwendet.

dwData1

Ein Zeiger auf eine CONVCONTEXT-Struktur, die Kontextinformationen für die Konversation enthält. Wenn der Client keine DDEML-Anwendung ist, wird dieser Parameter auf 0 festgelegt.

dwData2

Gibt an, ob der Client die gleiche Anwendungsinstanz wie der Server ist. Wenn der Parameter 1 ist, ist der Client dieselbe Instanz. Wenn der Parameter 0 ist, ist der Client eine andere Instanz.

Rückgabewert

Der Server sollte ein Datenhandl zurückgeben, das ein Array von HSZPAIR-Strukturen identifiziert. Das Array sollte eine Struktur für jedes Dienstnamen- und Themennamenpaar enthalten, das dem vom Client angeforderten Dienstnamen- und Themennamenpaar entspricht. Das Array muss durch ein NULL-Zeichenfolgenhand handle beendet werden. Das System sendet die XTYP _ CONNECT _ CONFIRM-Transaktion an den Server, um jede Konversation zu bestätigen und die Konversationshandles an den Server zu übergeben. Der Server erhält diese Bestätigungen nicht, wenn er das CBF _ SKIP CONNECT _ _ CONFIRMS-Flag in der DdeInitialize-Funktion angegeben hat.

Der Server sollte NULL zurückgeben, um die XTYP _ WILDCONNECT-Transaktion abzulehnen.

Hinweise

Diese Transaktion wird gefiltert, wenn die Serveranwendung das CBF _ FAIL _ CONNECTIONS-Flag in der DdeInitialize-Funktion angegeben hat.

Ein Server kann diesen Transaktionstyp nicht blockieren. Der CBR _ BLOCK-Rückgabecode wird ignoriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Ddeml.h (include Windows.h)

Weitere Informationen

Referenz

CONVCONTEXT

DdeConnect

DdeInitialize

HSZPAIR

Konzeptionellen

dynamische Daten Exchange Management Library