DdeFreeDataHandle 函数 (ddeml.h)

释放动态数据交换 (DDE) 对象，并删除与该对象关联的数据句柄。

语法

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

[in] hData

类型： HDDEDATA

要释放的 DDE 对象的句柄。此句柄必须由先前对 DdeCreateDataHandle 函数的调用创建或由 DdeClientTransaction 函数返回。

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

DdeGetLastError 函数可用于获取错误代码，该错误代码可以是以下值之一：

在以下情况下，应用程序必须调用 DdeFreeDataHandle ：

释放应用程序通过调用 DdeCreateDataHandle 函数分配的 DDE 对象（如果应用程序从未将对象的数据句柄传递给另一个动态数据交换管理库 (DDEML) 函数）
释放应用程序分配的 DDE 对象，方法是在调用 DdeCreateDataHandle 时指定HDATA_APPOWNED标志
释放处理从 DdeClientTransaction 函数接收的应用程序的 DDE 对象

当无所有者对象由 DDE 回调函数返回或用作 DDEML 函数中的参数时，系统会自动释放其句柄。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	ddeml.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll