XTYP _ ADPROTOKOLLQ-Transaktion

Die XTYP _ ADPROTOKOLLQ-Transaktion informiert den Server darüber, dass eine Advise-Transaktion für das angegebene Themennamen- und Elementnamenpaar aus steht und dass sich die Daten für das Themennamen- und Elementnamenpaar geändert haben. Das System sendet diese Transaktion an die DDE-Rückruffunktion (dynamische Daten 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 Konversation.

hsz1

Ein Handle für den Themennamen.

hsz2

Ein Handle für den Elementnamen, der geändert wurde.

hdata

Wird nicht verwendet.

dwData1

Die Anzahl der XTYP _ ADTYPQ-Transaktionen, die im Kontext des aktuellen Aufrufs der DdePostAdvise-Funktion für dasselbe Thema, Element und den gleichen Formatnamen verarbeitet werden müssen, im niedrig geordneten Wort. Die Anzahl ist 0 (null), wenn die aktuelle XTYP _ ADPROTOKOLLQ-Transaktion die letzte ist. Ein Server kann diese Anzahl verwenden, um zu bestimmen, ob ein HDATA _ APPOWNED-Datenhand handle für die Advise-Daten erstellt werden soll.

Das Wort in niedriger Reihenfolge wird auf CADV _ LATEACK festgelegt, wenn die DDEML die XTYP _ ADDIZQ-Transaktion ausgegeben hat, weil eine zu spät eintreffende DDE-ACK-Nachricht von einem Client ausgegeben wurde, der vom Server nicht ausgeführt _ wird.

Das hochgeordnete Wort 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 das Handle zurückgeben. Der Server sollte NULL zurückgeben, wenn die Transaktion nicht abgeschlossen werden kann.

Bemerkungen

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

Weitere Informationen

Verweis

DdeCreateDataHandle

DdeInitialize

DdePostAdvise

Konzept

dynamische Daten Exchange Management Library