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

Статья
08/23/2023

Добавляет данные в указанный объект динамического обмена данными (DDE). Приложение может добавлять данные, начиная с любого смещения от начала объекта. Если новые данные перекрываются уже в объекте , новые данные перезаписывают старые данные в байтах, где происходит перекрытие. Содержимое расположений в объекте, которые не были записаны, не определено.

Синтаксис

HDDEDATA DdeAddData(
  [in] HDDEDATA hData,
  [in] LPBYTE   pSrc,
  [in] DWORD    cb,
  [in] DWORD    cbOff
);

Параметры

[in] hData

Тип: HDDEDATA

Дескриптор объекта DDE, который получает дополнительные данные.

[in] pSrc

Тип: LPBYTE

Данные, добавляемые в объект DDE.

[in] cb

Тип: DWORD

Длина (в байтах) данных, добавляемых в объект DDE, включая завершающее значение NULL, если данные являются строкой.

[in] cbOff

Тип: DWORD

Смещение в байтах от начала объекта DDE. Дополнительные данные копируются в объект , начиная с этого смещения.

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

Тип: HDDEDATA

Если функция выполняется успешно, возвращаемое значение представляет собой новый дескриптор объекта DDE. Новый дескриптор используется во всех ссылках на объект .

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

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

После того как дескриптор данных использовался в качестве параметра в другой функции библиотеки управления динамическими данными или был возвращен функцией обратного вызова DDE, дескриптор можно использовать только для доступа на чтение к объекту DDE, определенному дескриптором.

Если объем выделенной памяти меньше, чем требуется для хранения добавленных данных, DdeAddData перераспределяет глобальный объект памяти соответствующего размера.

Требования

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