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

Освобождает объект динамического обмена данными (DDE) и удаляет дескриптор данных, связанный с объектом .

Синтаксис

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Параметры

[in] hData

Тип: HDDEDATA

Дескриптор освобождаемого объекта DDE. Этот дескриптор должен быть создан при предыдущем вызове функции DdeCreateDataHandle или возвращен функцией DdeClientTransaction .

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

Тип: BOOL

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

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

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

Комментарии

Приложение должно вызывать DdeFreeDataHandle в следующих случаях:

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

Требования

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

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

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

DdeAccessData

DdeClientTransaction

DdeCreateDataHandle

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

Справочные материалы