DdeFreeDataHandle

【勇芳软件工作室】汉化HomePreviousNext

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

BOOL DdeFreeDataHandle(

HDDEDATA 【HDATA】//处理DDE对象
); 

参数

【HDATA】

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

返回值

如果函数成功,返回值不为零。

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

错误

DdeGetLastError函数可用于获取错误代码,可能是以下值之一:

DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR

备注

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

*如果对象的数据句柄从来没有被应用程序传递到另一个动态数据交换管理库(DDEML)函数,通过调用DdeCreateDataHandle函数释放应用程序分配的DDE对象

*通过在DdeCreateDataHandle的调用中指定HDATA_APPOWNED标志来释放分配的应用程序的DDE对象

*释放从DdeClientTransaction函数接收应用程序的DDE对象

当DDE回调函数返回其句柄时,系统会自动释放未知对象,或者在DDEML函数中用作参数。

也可以看看

DdeAccessData, DdeCreateDataHandle, DdeClientTransaction