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 |
|