网站首页  词典首页

请输入您要查询的函数:

 

术语 ddefreedatahandle
释义 DdeFreeDataHandle
语法:
BOOL DdeFreeDataHandle( HDDEDATA hData
);
DdeFreeDataHandle功能
该DdeFreeDataHandle函数释放一个动态数据交换(DDE)对象和删除数据处理与对象关联。
参数
hData
[在,出]句柄DDE的对象被释放。这种处理,必须是被以前的调用DdeCreateDataHandle功能的DdeClientTransaction函数返回或创建。
返回值
如果函数成功,返回值为非零。
如果函数失败,返回值是零。
该DdeGetLastError函数可用于获得错误代码,它可以是下列值之一:
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
备注
应用程序必须调用在下列情况下DdeFreeDataHandle:
为了摆脱一个DDE对象通过调用DdeCreateDataHandle函数,如果该对象的数据处理,未能通过应用程序到另一个动态数据交换管理库(DDEML的)函数分配的应用
为了摆脱一个DDE对象,在指定的DdeCreateDataHandle调用HDATA_APPOWNED旗分配的应用
为了摆脱一个DDE对象,其处理程序收到DdeClientTransaction函数
系统会自动释放的无主对象的句柄时返回一个DDE回调函数或者是作为一个DDEML函数的参数。
功能信息
最低DLL版本 user32.dll
在Ddeml.h HeaderDeclared,头文件:winuser.h
import libraryUser32.lib
最低操作系统Windows 95,Windows NT 3.1
参见
动态数据交换管理库概况,DdeAccessData,DdeCreateDataHandle,DdeClientTransaction
==英文原文==DdeFreeDataHandle Function
The DdeFreeDataHandle function frees a Dynamic Data Exchange (DDE) object and deletes the data handle associated with the object.
Syntax
BOOL DdeFreeDataHandle( HDDEDATA hData
);
Parameters
hData
[in, out] Handle to the DDE object to be freed. This handle must have been created by a previous call to the DdeCreateDataHandle function or returned by the DdeClientTransaction function.
Return Value
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
The DdeGetLastError function can be used to get the error code, which can be one of the following values:
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
Remarks
An application must call DdeFreeDataHandle under the following circumstances:
To free a DDE object that the application allocated by calling the DdeCreateDataHandle function if the object's data handle was never passed by the application to another Dynamic Data Exchange Management Library (DDEML) function
To free a DDE object that the application allocated by specifying the HDATA_APPOWNED flag in a call to DdeCreateDataHandle
To free a DDE object whose handle the application received from the DdeClientTransaction function
The system automatically frees an unowned object when its handle is returned by a DDE callback function or is used as a parameter in a DDEML function.
Function Information
Minimum DLL Versionuser32.dll
HeaderDeclared in Ddeml.h, include Windows.h
Import libraryUser32.lib
Minimum operating systemsWindows 95, Windows NT 3.1
See Also
Dynamic Data Exchange Management Library Overview , DdeAccessData , DdeCreateDataHandle , DdeClientTransaction
==原始网址==http://msdn.microsoft.com/en-us/library/ms648752(VS.85).aspx\n
随便看

 

windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。

 

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间:2024/10/6 11:27:41