Функция DdePostAdvise (ddeml.h)

Статья
02/26/2024

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

Синтаксис

BOOL DdePostAdvise(
  [in] DWORD idInst,
  [in] HSZ   hszTopic,
  [in] HSZ   hszItem
);

Параметры

[in] idInst

Тип: DWORD

Идентификатор экземпляра приложения, полученный при предыдущем вызове функции DdeInitialize .

[in] hszTopic

Тип: HSZ

Дескриптор строки, указывающей имя раздела. Чтобы отправлять уведомления для всех разделов с активными циклами рекомендаций, приложение может задать для этого параметра значение 0L.

[in] hszItem

Тип: HSZ

Дескриптор строки, указывающей имя элемента. Чтобы отправлять уведомления для всех элементов с активными циклами рекомендаций, приложение может задать для этого параметра значение 0L.

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

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Функция DdeGetLastError может использоваться для получения кода ошибки, который может быть одним из следующих значений:

Сервер, имеющий нечислимое количество разделов или элементов, должен задать для параметров hszTopic и hszItemзначение NULL , чтобы система создавала транзакции для всех активных циклов рекомендаций. Функция обратного вызова DDE сервера возвращает значение NULL для всех циклов рекомендаций, которые не должны обновляться.

Если сервер вызывает DdePostAdvise с набором имен раздела, элемента и формата, который включает набор, обрабатываемый в настоящее время в XTYP_ADVREQ обратном вызове, может возникнуть переполнение стека.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ddeml.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll