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

另请参阅

CONVINFO

概念性

DdeClientTransaction

DdeConnect

DdeConnectList

DdeKeepStringHandle

DdeQueryNextServer

动态数据交换管理库

引用