DdeConnectList功能与支持指定服务名称和主题名称对的所有服务器应用程序建立对话。应用程序也可以使用此函数通过将函数传递给现有的会话句柄来获取会话句柄的列表。动态数据交换管理库从对话列表中删除任何终止对话的句柄。所产生的会话列表包含支持指定的服务名称和主题名称的所有当前建立的会话的句柄。
HCONVLIST DdeConnectList（
| DWORD 【idInst】, | //实例标识符en |
| HSZ 【hszService】, | //处理服务名称字符串 |
| HSZ 【hszTopic】, | //处理主题名称字符串 |
| HCONVLIST 【hConvList】, | //对话列表处理 |
| PCONVCONTEXT 【pCC】 | //指向具有上下文数据的结构的指针 |
| ); |
参数
【idInst】
指定通过先前调用DdeInitialize函数获得的应用程序实例标识符。
【hszService】
标识指定要建立会话的服务器应用程序的服务名称的字符串。如果此参数为0L，系统将尝试与支持指定主题名称的所有可用服务器建立会话。
【hszTopic】
标识指定要建立会话的主题名称的字符串。此句柄必须先前调用DdeCreateStringHandle函数创建。如果此参数为0L，系统将尝试在所选服务器（或服务器）支持的所有主题上建立对话。
【hConvList】
标识要列举的会话列表。如果要建立新的对话列表，该参数应为0L。
【pCC】
指向包含会话上下文信息的CONVCONTEXT结构。如果此参数为NULL，则服务器在XTYP_CONNECT或XTYP_WILDCONNECT事务期间接收默认的CONVCONTEXT结构。
返回值
如果函数成功，则返回值是新对话列表的句柄。
如果函数失败，返回值为0L。旧对话列表的句柄不再有效。
错误
DdeGetLastError函数可用于获取错误代码，可能是以下值之一：
DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALID_PARAMETER
DMLERR_NO_CONV_ESTABLISHED
DMLERR_NO_ERROR
DMLERR_SYS_ERROR
备注
应用程序必须释放DdeConnectList函数返回的会话列表句柄，而不管列表中的任何会话句柄是否处于活动状态。要释放句柄，应用程序可以调用DdeDisconnectList.
默认CONVCONTEXT结构的所有成员除cb（指定结构的大小）和iCodePage（除了指定CP_WINANSI（默认代码页）或CP_WINUNICODE）之外，均被设置为零，具体取决于ANSI或Unicode版本客户端应用程序调用了DdeInitialize函数。
也可以看看
CONVCONTEXT, DdeConnect, DdeCreateStringHandle, DdeDisconnect, DdeDisconnectList, DdeInitialize, DdeQueryNextServer
