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
Ddeml.h (include Windows.h)

Siehe auch

Referenz

CONVCONTEXT

DdeConnect

DdeInitialize

Konzept

dynamische Daten Exchange-Verwaltungsbibliothek