DdeQueryConvInfo函数获取有关动态数据交换(DDE)交易以及交易发生的对话的信息。
UINT DdeQueryConvInfo
HCONV 【hConv】, | //处理对话 |
DWORD 【idTransaction】, | //事务标识符en |
PCONVINFO 【pConvInfo】 | //指向具有会话数据的结构的指针 |
); |
参数
【hConv】
识别对话。
【idTransaction】
指定事务。对于异步事务,此参数应为DdeClientTransaction函数返回的事务标识符。对于同步事务,此参数应为QID_SYNC。
【pConvInfo】
指向CONVINFO结构的信息,该结构接收有关事务和会话的信息。CONVINFO结构的cb成员必须指定为结构分配的缓冲区的长度。
返回值
如果函数成功,则返回值是复制到CONVINFO结构中的字节数。
如果函数失败,返回值为FALSE。
错误
DdeGetLastError函数可用于获取错误代码,可能是以下值之一:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_NO_CONV_ESTABLISHED
DMLERR_NO_ERROR
DMLERR_UNFOUND_QUEUE_ID
备注
应用程序不应该释放CONVINFO结构引用的字符串句柄。如果应用程序必须使用这些字符串句柄之一,则应调用DdeKeepStringHandle函数创建句柄的副本。
如果【idTransaction】参数设置为QID_SYNC,则CONVINFO结构的房屋da成员与会话相关联,可用于保存与会话相关联的数据。如果【idTransaction】是异步事务的标识符,则房屋da成员仅与当前事务相关联,并且仅在事务持续期间有效。
也可以看看
CONVINFO, DdeClientTransaction, DdeConnect, DdeConnectList, DdeKeepStringHandle, DdeQueryNextServer