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 |
|
Siehe auch
-
Referenz
-
Konzept