CONVINFO结构包含有关DDE会话的信息。
typedef struct tagCONVINFO { // ci
DWORD cb;
DWORD hUser;
HCONV hConvPartner;
HSZ hszSvcPartner;
HSZ hszServiceReq;
HSZ hszTopic;
HSZ hszItem;
UINT wFmt;
UINT wType;
UINT wStatus;
UINT wConvst;
UINT wLastError;
HCONVLIST hConvList;
CONVCONTEXT ConvCtxt;
HWND hwnd;
HWND hwndPartner;
} CONVINFO;
会员
cb
指定结构的大小(以字节为单位)。
房屋da
标识应用程序定义的数据。
hConvPartner
标识DDE对话中的合作伙伴应用程序。如果合作伙伴没有注册自己(使用DdeInitialize功能)来创建DDE管理库(DDEML)函数调用,则该成员为零。应用程序不应该将此成员传递给除DdeQueryConvInfo之外的任何DDEML函数。
hszSvcPartner
标识伙伴应用程序的服务名称。
hszServiceReq
标识请求连接的服务器应用程序的服务名称。
hszTopic
标识所请求主题的名称。
hszItem
标识所请求的项目的名称。这个成员是具体的交易。
WFMT
指定正在交换的数据的格式。这个成员是具体的交易。
WTYPE
指定当前事务的类型。这个成员是具体的交易;它可以是以下值之一:
值 | 含义 |
XTYP_ADVDATA | 通知服务器提示数据的客户端已经到达。 |
XTYP_ADVREQ | 请求服务器在建议循环期间向客户端发送更新的数据。服务器调用DdePostAdvise时会导致此事务。 |
XTYP_ADVSTART | 请求服务器与客户端开始建议循环。 |
XTYP_ADVSTOP | 通知服务器建议循环正在停止。 |
XTYP_CONNECT | 请求服务器与客户端建立对话。 |
XTYP_CONNECT_CONFIRM | 通知服务器与客户端的对话已建立。 |
XTYP_DISCONNECT | 通知服务器对话已经终止。 |
XTYP_EXECUTE | 请求服务器执行客户端发送的命令。 |
XTYP_MONITOR | 通知正在发送DDE数据的注册为APPCMD_MONITOR的应用程序。 |
XTYP_POKE | 请求服务器接受客户端的非请求数据。 |
XTYP_REGISTER | 通知服务器已注册服务名称的其他DDEML应用程序。 |
XTYP_REQUEST | 请求服务器向客户端发送数据。 |
XTYP_UNREGISTER | 通知服务器取消注册服务名称的其他DDEML应用程序。 |
XTYP_WILDCONNECT | 请求服务器与同一客户端建立多个对话。 |
XTYP_XACT_COMPLETE | 通知客户端异步数据事务已经完成。 |
wStatuslb
指定当前会话的状态。该成员可以是以下值的组合:
值 | 含义 |
ST_ADVISE | 一个或多个链接正在进行中。 |
ST_BLOCKED | 对话被阻止。 |
ST_BLOCKNEXT | 调用下一个回调后,会话将会被阻止。 |
ST_CLIENT | 传递给DdeQueryConvInfo函数的会话句柄是一个客户端句柄。如果句柄为零,则传递给DdeQueryConvInfo函数的会话句柄是服务器端句柄。 |
ST_CONNECTED | 会话已连接。 |
ST_INLIST | 对话是会话列表的成员。 |
ST_ISLOCAL | 对话的双方都在使用DDEML。 |
ST_ISSELF | 对话的双方都使用与DDEML相同的实例。 |
ST_TERMINATED | 对话已被合作伙伴终止。 |
wConvst
指定会话状态。该成员可以是以下值之一:
值 | 含义 |
XST_ADVACKRCVD | 建议交易刚刚完成。 |
XST_ADVDATAACKRCVD | 建议数据交易刚刚完成。 |
XST_ADVDATASENT | 建议数据已经发送,正在等待确认。 |
XST_ADVSENT | 建议交易正在等待确认。 |
XST_CONNECTED | 会话没有活动的交易。 |
XST_DATARCVD | 所要求的数据刚刚收到。 |
XST_EXECACKRCVD | 执行事务刚刚完成。 |
XST_EXECSENT | 执行事务正在等待确认。 |
XST_INCOMPLETE | 最后一笔交易失败。 |
XST_INIT1 | 中启动状态1。 |
XST_INIT2 | 中启动状态2。 |
XST_NULL | 预启动状态。 |
XST_POKEACKRCVD | 捅交易刚刚完成。 |
XST_POKESENT | 捅交易正在等待确认。 |
XST_REQSENT | 请求事务正在等待确认。 |
XST_UNADVACKRCVD | 一个不可战胜的交易刚刚完成。 |
XST_UNADVSENT | 一个未决的交易正在等待确认。 |
wLastError
指定与最后一个事务关联的错误值。
hConvList
如果当前会话的句柄在会话列表中,则标识对话列表。如果对话不在会话列表中,则该成员为NULL。
ConvCtxt
指定会话上下文。
HWND
标识对话中涉及的呼叫应用程序的窗口。
hwndPartner
标识当前会话中涉及的合作伙伴应用程序的窗口。
也可以看看