XTYP_REQUEST Transaktion

Ein Client verwendet die XTYP_REQUEST Transaktion, um Daten von einem Server anzufordern. Die DDE-Serverrückruffunktion (Dynamic Data Exchange), DdeCallback, empfängt diese Transaktion, wenn ein Client XTYP_REQUEST in der DdeClientTransaction-Funktion angibt.

#define     XCLASS_DATA              0x2000
#define     XTYP_REQUEST            (0x00B0 | XCLASS_DATA          )

Parameter

uType

Der Transaktionstyp:

uFmt

Das Format, in dem der Server Daten an den Client übermitteln soll.

hconv

Ein Handle für die Unterhaltung.

hsz1

Ein Handle für den Themennamen.

hsz2

Ein Handle für den Elementnamen.

hdata

Wird nicht verwendet.

dwData1

Wird nicht verwendet.

dwData2

Wird nicht verwendet.

Rückgabewert

Der Server sollte die DdeCreateDataHandle-Funktion aufrufen, um ein Datenhandle zu erstellen, das die Daten identifiziert und dann das Handle zurückgibt. Der Server sollte NULL zurückgeben, wenn er die Transaktion nicht abschließen kann. Wenn der Server NULL zurückgibt, erhält der Client ein DDE_FNOTPROCESSED-Flag.

Bemerkungen

Diese Transaktion wird gefiltert, wenn die Serveranwendung das CBF_FAIL_REQUESTS-Flag in der Funktion DdeInitialize angegeben hat.

Wenn für die Reaktion auf diese Transaktion eine langwierige Verarbeitung erforderlich ist, kann der Server den CBR_BLOCK Rückgabecode zurückgeben, um zukünftige Transaktionen in der aktuellen Unterhaltung auszusetzen und die Transaktion dann asynchron zu verarbeiten. Wenn der Server abgeschlossen ist und die Daten an den Client übergeben werden können, kann der Server die DdeEnableCallback-Funktion aufrufen, um die Konversation fortzusetzen.

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 (windows.h einschließen)

Siehe auch

Referenz

DdeClientTransaction

DdeCreateDataHandle

DdeEnableCallback

DdeInitialize

Konzept

Dynamic Data Exchange Management Library