Freigeben über


XTYP_WILDCONNECT Transaktion

Ermöglicht einem Client das Einrichten einer Unterhaltung für jedes Dienst- und Themennamenpaar des Servers, die mit dem angegebenen Dienstnamen und dem angegebenen Themennamen übereinstimmen. Eine DDE-Serverrückruffunktion (Dynamic Data 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 zu allen Themennamen an, die vom Server unterstützt werden.

hsz2

Ein Handle für den Dienstnamen. Wenn dieser Parameter NULL ist, fordert der Client eine Konversation für alle Dienstnamen an, die vom Server unterstützt werden.

hdata

Wird nicht verwendet.

dwData1

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

dwData2

Gibt an, ob es sich beim Client um dieselbe Anwendung instance wie der Server handelt. Wenn der Parameter 1 ist, ist der Client instance identisch. Wenn der Parameter 0 ist, ist der Client ein anderer instance.

Rückgabewert

Der Server sollte ein Datenhandle zurückgeben, das ein Array von HSZPAIR-Strukturen identifiziert. Das Array sollte eine Struktur für jedes Dienst- und Themenname-Paar enthalten, das dem vom Client angeforderten Paar Dienstname und Themaname entspricht. Das Array muss durch ein NULL-Zeichenfolgenhandle 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.

Bemerkungen

Diese Transaktion wird gefiltert, wenn die Serveranwendung das CBF_FAIL_CONNECTIONS-Flag in der Funktion DdeInitialize 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 (einschließlich Windows.h)

Siehe auch

Referenz

CONVCONTEXT

DdeConnect

DdeInitialize

HSZPAIR

Konzept

Verwaltungsbibliothek für dynamische Daten