XTYP_CONNECT Transaktion
Ein Client verwendet die XTYP_CONNECT Transaktion, um eine Unterhaltung einzurichten. Eine Dynamic Data Exchange (DDE)-Server-Rückruffunktion, DdeCallback, empfängt diese Transaktion, wenn ein Client einen Dienstnamen angibt, den der Server unterstützt (und einen Themanamen, der nicht NULL ist) in einem Aufruf der DdeConnect-Funktion.
#define XCLASS_BOOL 0x1000
#define XTYPF_NOBLOCK 0x0002
#define XTYP_CONNECT (0x0060 | XCLASS_BOOL | XTYPF_NOBLOCK)
Parameter
-
uType
-
Der Transaktionstyp:
-
uFmt
-
Wird nicht verwendet.
-
hconv
-
Wird nicht verwendet.
-
hsz1
-
Ein Handle zum Themanamen.
-
hsz2
-
Ein Handle zum Dienstnamen.
-
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, ist dieser Parameter 0.
-
dwData2
-
Gibt an, ob der Client dieselbe 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
Eine Server-Rückruffunktion sollte TRUE zurückgeben, damit der Client eine Unterhaltung im angegebenen Dienstnamen- und Themennamenpaar einrichten kann, oder die Funktion sollte FALSE zurückgeben, um die Unterhaltung zu verweigern. Wenn die Rückruffunktion TRUE zurückgibt und eine Unterhaltung erfolgreich eingerichtet wird, übergibt das System den Unterhaltungshandpunkt an den Server, indem eine XTYP_CONNECT_CONFIRM Transaktion an die Rückruffunktion des Servers ausgestellt wird (es sei denn, der Server hat das CBF_SKIP_CONNECT_CONFIRMS Flag in der DdeInitialize-Funktion angegeben).
Hinweise
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.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|