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

Статья
08/23/2023

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

Синтаксис

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Параметры

[in] hData

Тип: HDDEDATA

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

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

Тип: BOOL

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

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

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

Освобождение объекта 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