Freigeben über


XTYP_ADVREQ Transaktion

Die XTYP_ADVREQ Transaktion informiert den Server darüber, dass eine Beratungstransaktion für das angegebene Themennamen- und Elementnamenpaar ausstehenden Ist und dass die Daten, die dem Themanamen- und Elementnamenpaar entsprechen, geändert wurden. Das System sendet diese Transaktion an die DDE-Rückruffunktion (Dynamic Data Exchange), DdeCallback, nachdem der Server die DdePostAdvise-Funktion aufruft.

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_ADVREQ             (0x0020 | XCLASS_DATA | XTYPF_NOBLOCK )

Parameter

uType

Der Transaktionstyp:

uFmt

Das Format, in dem die Daten an den Client übermittelt werden sollen.

hconv

Ein Handle für die Unterhaltung.

hsz1

Ein Handle zum Themanamen.

hsz2

Ein Handle zum Elementnamen, der geändert wurde.

hdata

Wird nicht verwendet.

dwData1

Die Anzahl XTYP_ADVREQ Transaktionen , die im Rahmen des aktuellen Aufrufs der DdePostAdvise-Funktion im Kontext des aktuellen Aufrufs der DdePostAdvise-Funktion gespeichert bleiben, die im selben Thema, element und formatiert werden sollen. Die Anzahl ist null, wenn die aktuelle XTYP_ADVREQ Transaktion der letzte ist. Ein Server kann diese Anzahl verwenden, um zu bestimmen, ob ein HDATA_APPOWNED Datenhandle für die Beratungsdaten erstellt werden soll.

Das Wort mit niedriger Reihenfolge wird auf CADV_LATEACK festgelegt, wenn die DDEML die XTYP_ADVREQ Transaktion aufgrund einer verspäteten DDE_ACK Nachricht von einem Client ausgegeben hat, der vom Server aus ausgeführt wird.

Das Wort mit hoher Reihenfolge wird nicht verwendet.

dwData2

Wird nicht verwendet.

Rückgabewert

Der Server sollte zuerst die DdeCreateDataHandle-Funktion aufrufen, um ein Datenhandle zu erstellen, das die geänderten Daten identifiziert und dann den Handle zurückgibt. Der Server sollte NULL zurückgeben, wenn die Transaktion nicht abgeschlossen werden kann.

Hinweise

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

Weitere Informationen

Referenz

DdeCreateDataHandle

DdeInitialize

DdePostAdvise

Konzept

Dynamische Daten Exchange Verwaltungsbibliothek