DdeConnect 函数 (ddeml.h)

项目
02/26/2024

与支持指定服务名称和主题名称对的服务器应用程序建立会话。如果存在多个此类服务器，则系统仅选择一个。

语法

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in, optional] PCONVCONTEXT pCC
);

参数

[in] idInst

类型：DWORD

由上一次调用 DdeInitialize 函数获取的应用程序实例标识符。

[in] hszService

类型： HSZ

字符串的句柄，指定要与之建立会话的服务器应用程序的服务名称。此句柄必须由之前对 DdeCreateStringHandle 函数的调用创建。如果此参数为 0L，则会与任何可用服务器建立会话。

[in] hszTopic

类型： HSZ

字符串的句柄，指定要建立会话的主题的名称。此句柄必须由先前调用 DdeCreateStringHandle 创建。如果此参数为 0L，则会就所选服务器支持的任何主题建立对话。

[in, optional] pCC

类型： PCONVCONTEXT

指向包含会话上下文信息的 CONVCONTEXT 结构的指针。如果此参数为 NULL，则服务器会在XTYP_CONNECT或XTYP_WILDCONNECT事务期间接收默认 CONVCONTEXT 结构。

返回值

类型： HCONV

如果函数成功，则返回值是已建立的会话的句柄。

如果函数失败，则返回值为 0L。

DdeGetLastError 函数可用于获取错误代码，该错误代码可以是以下值之一：

注解

客户端应用程序无法对所选服务器做出假设。如果在 hszService 参数中指定了特定于实例的名称，则仅使用指定的实例建立会话。在 XTYP_REGISTER和XTYP_UNREGISTER 事务期间，特定于实例的服务名称将传递到应用程序的动态数据交换 (DDE ) 回调函数。

默认 CONVCONTEXT 结构的所有成员都设置为零，但 cb（指定结构的大小）和 iCodePage（指定 CP_WINANSI (默认代码页) 或 CP_WINUNICODE，具体取决于客户端应用程序是否调用了 DdeInitialize 函数的 ANSI 或 Unicode 版本。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	ddeml.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll