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

Статья
08/23/2023

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

Синтаксис

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

Параметры

[in] idInst

Тип: DWORD

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

[in, optional] pSrc

Тип: LPBYTE

Данные для копирования в объект DDE. Если этот параметр имеет значение NULL, данные не копируются в объект .

[in] cb

Тип: DWORD

Объем памяти в байтах для копирования из буфера, на который указывает pSrc. (включите завершающее значение NULL, если данные являются строкой). Если этот параметр равен нулю, параметр pSrc игнорируется.

[in] cbOff

Тип: DWORD

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

[in, optional] hszItem

Тип: HSZ

Дескриптор строки, указывающей элемент данных, соответствующий объекту DDE. Этот дескриптор должен быть создан при предыдущем вызове функции DdeCreateStringHandle . Если дескриптор данных будет использоваться в XTYP_EXECUTE транзакции, этот параметр должен иметь значение 0L.

[in] wFmt

Тип: UINT

Стандартный формат буфера обмена данных.

[in] afCmd

Тип: UINT

Флаги создания. Этот параметр может быть HDATA_APPOWNED, который указывает, что серверное приложение, вызывающее функцию DdeCreateDataHandle , владеет дескриптором данных, создаваемым этой функцией. Этот флаг позволяет приложению совместно использовать дескриптор данных с другими приложениями DDEML, а не создавать отдельный дескриптор для передачи каждому приложению. Если этот флаг указан, приложение должно в конечном итоге освободить объект общей памяти, связанный с дескриптором, с помощью функции DdeFreeDataHandle . Если этот флаг не указан, дескриптор становится недопустимым в приложении, которое создало дескриптор после возврата дескриптора данных функцией обратного вызова DDE приложения или используется в качестве параметра в другой функции DDEML.

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

Тип: HDDEDATA

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

Если функция завершается сбоем, возвращается значение 0L.

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

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

Требования


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