CONVINFO 结构 (ddeml.h)

  • 项目

包含有关动态数据交换 (DDE) 对话的信息。

语法

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   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, *PCONVINFO;

成员

cb

类型：DWORD

结构的大小（以字节为单位）。

hUser

类型： DWORD_PTR

应用程序定义的数据。

hConvPartner

类型： HCONV

DDE 对话中合作伙伴应用程序的句柄。 如果合作伙伴尚未使用 DdeInitialize 函数) 进行 DDEML 函数调用 (注册自己，则此成员为零。 应用程序不应将此成员传递给除 DdeQueryConvInfo 以外的任何 DDEML 函数。

hszSvcPartner

类型： HSZ

合作伙伴应用程序的服务名称的句柄。

hszServiceReq

类型： HSZ

请求进行连接的服务器应用程序的服务名称的句柄。

hszTopic

类型： HSZ

请求的主题名称的句柄。

hszItem

类型： HSZ

所请求项名称的句柄。 此成员特定于事务。

wFmt

类型： UINT

要交换的数据的格式。 此成员特定于事务。

wType

类型： UINT

当前事务的类型。 此成员特定于事务;可以是以下值之一。

值 含义
XTYP_ADVDATA
0x4010
 通知客户端建议来自服务器的数据已到达。
XTYP_ADVREQ
0x2022
 请求服务器在建议循环期间向客户端发送更新的数据。 当服务器调用 DdePostAdvise 时，此事务将产生。
XTYP_ADVSTART
0x1030
 请求服务器使用客户端启动建议循环。
XTYP_ADVSTOP
0x8040
 通知服务器建议循环正在停止。
XTYP_CONNECT
0x1062
 请求服务器与客户端建立会话。
XTYP_CONNECT_CONFIRM
0x8072
 通知服务器已建立与客户端的会话。
XTYP_DISCONNECT
0x80C2
 通知服务器会话已终止。
XTYP_EXECUTE
0x4050
 请求服务器执行客户端发送的命令。
XTYP_MONITOR
0x80F2
 通知注册为 APPCMD_MONITOR 的应用程序正在传输 DDE 数据。
XTYP_POKE
0x4090
 请求服务器接受来自客户端的未经请求的数据。
XTYP_REGISTER
0x80A2
 通知其他 DDEML 应用程序服务器已注册服务名称。
XTYP_REQUEST
0x20B0
 请求服务器将数据发送到客户端。
XTYP_UNREGISTER
0x80D2
 通知其他 DDEML 应用程序服务器已注销服务名称。
XTYP_WILDCONNECT
0x20E2
 请求服务器与同一客户端建立多个会话。
XTYP_XACT_COMPLETE
0x8080
 通知客户端异步数据事务已完成。

wStatus

类型： UINT

当前对话的状态。 此成员可以是以下一个或多个值。

值 含义
ST_ADVISE
0x0002
 一个或多个链接正在进行中。
ST_BLOCKED
0x0008
 会话被阻止。
ST_BLOCKNEXT
0x0080
 调用下一个回调后，会话将阻止。
ST_CLIENT
0x0010
 传递给 DdeQueryConvInfo 函数的 con0x0010versation 句柄是客户端句柄。 如果句柄为零，则传递给 DdeQueryConvInfo 函数的会话句柄是服务器端句柄。
ST_CONNECTED
0x0001
 会话已连接。
ST_INLIST
0x0040
 对话是对话列表的成员。
ST_ISLOCAL
0x0004
 对话的双方都使用 DDEML。
ST_ISSELF
0x0100
 会话的两端都使用 DDEML 的同一实例。
ST_TERMINATED
0x0020
 会话已被合作伙伴终止。

wConvst

类型： UINT

会话状态。 此成员可以是以下值之一。

值 含义
XST_ADVACKRCVD
13
 建议交易刚刚完成。
XST_ADVDATAACKRCVD
16
 建议数据事务刚刚完成。
XST_ADVDATASENT
15
 建议数据已发送，正在等待确认。
XST_ADVSENT
11
 建议事务正在等待确认。
XST_CONNECTED
2
 会话没有活动事务。
XST_DATARCVD
6
 刚刚收到请求的数据。
XST_EXECACKRCVD
10
 刚刚完成执行事务。
XST_EXECSENT
9
 执行事务正在等待确认。
XST_INCOMPLETE
1
 最后一个事务失败。
XST_INIT1
3
 中间启动状态 1。
XST_INIT2
4
 中间启动状态 2。
XST_NULL
0
 预启动状态。
XST_POKEACKRCVD
8
 poke 事务刚刚完成。
XST_POKESENT
7
 poke 事务正在等待确认。
XST_REQSENT
5
 请求事务正在等待确认。
XST_UNADVACKRCVD
14
 未添加的事务刚刚完成。
XST_UNADVSENT
12
 未添加的事务正在等待确认。

wLastError

类型： UINT

与最后一个事务关联的错误值。

hConvList

类型： HCONVLIST

如果当前会话的句柄位于会话列表中，则为会话列表的句柄。 如果会话不在会话列表中，则此成员为 NULL 。

ConvCtxt

类型： CONVCONTEXT

对话上下文。

hwnd

类型：HWND

会话中涉及的调用应用程序窗口的句柄。

hwndPartner

类型：HWND

当前会话中涉及的合作伙伴应用程序窗口的句柄。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 ddeml.h (包括 Windows.h)

请参阅

CONVCONTEXT

概念性

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

动态数据交换管理库

引用