XTYP_WILDCONNECT事务

  • 项目

使客户端能够在与指定的服务名称和主题名称匹配的每个服务器服务名称和主题名称对上建立会话。 当客户端 (在调用 DdeConnect 或 DdeConnectList 函数时指定 NULL 服务名称、NULL 主题名称或同时指定两者时，动态数据交换) DDE) 服务器回调函数 DdeCallback 接收此事务。

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_WILDCONNECT        (0x00E0 | XCLASS_DATA | XTYPF_NOBLOCK)

参数

uType

事务类型。

uFmt

未使用。

hconv

未使用。

hsz1

主题名称的句柄。 如果此参数为 NULL，则客户端请求针对服务器支持的所有主题名称进行会话。

hsz2

服务名称的句柄。 如果此参数为 NULL，则客户端请求服务器支持的所有服务名称上的会话。

hdata

未使用。

dwData1

指向包含会话上下文信息的 CONVCONTEXT 结构的指针。 如果客户端不是 DDEML 应用程序，则此参数设置为 0。

dwData2

指定客户端是否与服务器是同一应用程序实例。 如果 参数为 1，则客户端是同一实例。 如果 参数为 0，则客户端是另一个实例。

返回值

服务器应返回标识 HSZPAIR 结构数组的数据句柄。 对于与客户端请求的服务名称和主题名称对匹配的每个 service-name 和 topic-name 对，数组应包含一个结构。 数组必须由 NULL 字符串句柄终止。 系统将 XTYP_CONNECT_CONFIRM 事务发送到服务器，以确认每个会话并将会话句柄传递给服务器。 如果在 DdeInitialize 函数中指定了 CBF_SKIP_CONNECT_CONFIRMS 标志，服务器将不会收到这些确认。

服务器应返回 NULL 以拒绝 XTYP_WILDCONNECT 事务。

备注

如果服务器应用程序在 DdeInitialize 函数中指定了 CBF_FAIL_CONNECTIONS 标志，则会筛选此事务。

服务器无法阻止此事务类型;忽略CBR_BLOCK返回代码。

要求

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

另请参阅

引用

CONVCONTEXT

DdeConnect

DdeInitialize

HSZPAIR

概念性

动态数据交换管理库