XTYP _ CONNECT-Transaktion
Ein Client verwendet die XTYP _ CONNECT-Transaktion, um eine Konversation herzustellen. Eine dynamische Daten Exchange (DDE)-Serverrückruffunktion, DdeCallback,empfängt diese Transaktion, wenn ein Client einen Vom Server unterstützten Dienstnamen (und einen Themennamen, der nicht NULL ist) in einem Aufruf der DdeConnect-Funktion angibt.
#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 für den Themennamen.
-
hsz2
-
Ein Handle für den Dienstnamen.
-
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, ist dieser Parameter 0.
-
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
Eine Serverrückruffunktion sollte TRUE zurückgeben, damit der Client eine Konversation für das angegebene Dienstnamen- und Themennamenpaar herstellen kann, oder die Funktion sollte FALSE zurückgeben, um die Konversation zu verweigern. Wenn die Rückruffunktion TRUE zurückgibt und eine Konversation erfolgreich eingerichtet wurde, übergibt das System das Konversationshandle an den Server, indem es eine XTYP _ CONNECT _ CONFIRM-Transaktion an die Rückruffunktion des Servers ausgibt (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 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 |
|