DdeQueryConvInfo 函数 (ddeml.h)
检索有关动态数据交换 (DDE) 事务的信息,以及有关事务发生时的对话的信息。
语法
UINT DdeQueryConvInfo(
[in] HCONV hConv,
[in] DWORD idTransaction,
[in, out] PCONVINFO pConvInfo
);
参数
[in] hConv
类型: HCONV
会话的句柄。
[in] idTransaction
类型:DWORD
事务。 对于异步事务,此参数应该是 DdeClientTransaction 函数返回的事务标识符。 对于同步事务,应QID_SYNC此参数。
[in, out] pConvInfo
类型: PCONVINFO
指向 CONVINFO 结构的指针,该结构接收有关事务和会话的信息。 CONVINFO 结构的 cb 成员必须指定为结构分配的缓冲区的长度。
返回值
类型: UINT
如果函数成功,则返回值是复制到 CONVINFO 结构的字节数。
如果函数失败,则返回值为 FALSE。
DdeGetLastError 函数可用于获取错误代码,该错误代码可以是以下值之一:
注解
应用程序不应释放 CONVINFO 结构引用的字符串句柄。 如果应用程序必须使用这些字符串句柄之一,则应调用 DdeKeepStringHandle 函数来创建句柄的副本。
如果 idTransaction 参数设置为 QID_SYNC,则 CONVINFO 结构的 hUser 成员与会话相关联,并且可用于保存与会话关联的数据。 如果 idTransaction 是异步事务的标识符,则 hUser 成员仅与当前事务相关联,并且仅在事务期间有效。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ddeml.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
另请参阅
概念性
引用