Поделиться через


транзакция XTYP_ADVREQ

Транзакция XTYP_ADVREQ сообщает серверу о том, что транзакция рекомендации не выполняется в указанной паре имени раздела и имени элемента, а данные, соответствующие имени раздела и паре имен элементов, изменились. Система отправляет эту транзакцию в функцию обратного вызова динамических данных Exchange (DDE), DdeCallback после того, как сервер вызывает функцию DdePostAdvise.

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

Параметры

uType

Тип транзакции.

uFmt

Формат, в котором данные должны быть отправлены клиенту.

hconv

Дескриптор беседы.

hsz1

Дескриптор имени раздела.

hsz2

Дескриптор имени элемента, который изменился.

hdata

Не используется.

dwData1

Количество в слове с низким порядком XTYP_ADVREQ транзакций, которые остаются обрабатываемыми в том же разделе, элементе и имени формата, заданном в контексте текущего вызова функции DdePostAdvise . Число равно нулю, если текущая транзакция XTYP_ADVREQ является последней. Сервер может использовать это число, чтобы определить, следует ли создавать дескриптор данных HDATA_APPOWNED для данных рекомендаций.

Для слова с низким порядком задано значение CADV_LATEACK , если DDEML выдал транзакцию XTYP_ADVREQ из-за позднего поступления DDE_ACK сообщения от клиента, избытого сервером.

Слово высокого порядка не используется.

dwData2

Не используется.

Возвращаемое значение

Сервер должен сначала вызвать функцию DdeCreateDataHandle , чтобы создать дескриптор данных, который идентифицирует измененные данные, а затем возвращает дескриптор. Сервер должен возвращать значение NULL , если не удается завершить транзакцию.

Комментарии

Серверу не удается заблокировать этот тип транзакции; код возврата CBR_BLOCK игнорируется.

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Ddeml.h (include Windows.h)

См. также раздел

Ссылки

DdeCreateDataHandle

DdeInitialize

DdePostAdvise

Основные понятия

Библиотека управления динамическими данными Exchange