DdeAddData 函数 (ddeml.h)
将数据添加到指定的动态数据交换 (DDE) 对象。 应用程序可以添加从对象开头的任何偏移量开始的数据。 如果新数据与对象中已有的数据重叠,则新数据将覆盖发生重叠的字节中的旧数据。 对象中尚未写入的位置的内容是不确定的。
语法
HDDEDATA DdeAddData(
[in] HDDEDATA hData,
[in] LPBYTE pSrc,
[in] DWORD cb,
[in] DWORD cbOff
);
参数
[in] hData
类型: HDDEDATA
接收其他数据的 DDE 对象的句柄。
[in] pSrc
类型: LPBYTE
要添加到 DDE 对象中的数据。
[in] cb
类型:DWORD
要添加到 DDE 对象的数据的长度(以字节为单位),如果数据是字符串,则包括终止 NULL。
[in] cbOff
类型:DWORD
从 DDE 对象开头的偏移量(以字节为单位)。 从此偏移量开始,将附加数据复制到对象。
返回值
类型: HDDEDATA
如果函数成功,则返回值是 DDE 对象的新句柄。 新句柄用于对象的所有引用中。
如果函数失败,则返回值为零。
DdeGetLastError 函数可用于获取错误代码,该错误代码可以是以下值之一:
注解
将数据句柄用作另一个 动态数据交换管理库 函数中的参数或由 DDE 回调函数返回后,该句柄只能用于对该句柄标识的 DDE 对象的读取访问。
如果最初分配的内存量小于保存添加的数据所需的内存量, DdeAddData 将重新分配适当大小的全局内存对象。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ddeml.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
请参阅
概念性
引用