DdeConnect功能与支持指定服务名称和主题名称对的服务器应用程序建立对话。如果存在多个这样的服务器,则系统仅选择一个。
HCONV DdeConnect(
DWORD 【idInst】, | //实例标识符en |
HSZ 【hszService】, | //处理服务名称字符串 |
HSZ 【hszTopic】, | //处理主题名称字符串 |
PCONVCONTEXT 【pCC】 | //指向具有上下文数据的结构的指针 |
); |
参数
【idInst】
指定通过先前调用DdeInitialize函数获得的应用程序实例标识符。
【hszService】
标识指定要建立会话的服务器应用程序的服务名称的字符串。此句柄必须先前调用DdeCreateStringHandle函数创建。如果此参数为0L,则与任何可用服务器建立会话。
【hszTopic】
标识指定要建立会话的主题名称的字符串。此句柄必须由先前调用DdeCreateStringHandle创建。如果此参数为0L,则建立所选服务器支持的任何主题的会话。
【pCC】
指向包含会话上下文信息的CONVCONTEXT结构。如果此参数为NULL,则服务器在XTYP_CONNECT或XTYP_WILDCONNECT事务期间接收默认的CONVCONTEXT结构。
返回值
如果函数成功,则返回值是建立对话的句柄。
如果函数失败,返回值为0L。
错误
DdeGetLastError函数可用于获取错误代码,可能是以下值之一:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALIDPARAMETER
DMLERR_NO_CONV_ESTABLISHED
DMLERR_NO_ERROR
备注
客户端应用程序无法对所选服务器做出假设。如果在【hszService】参数中指定了特定于实例的名称,则仅使用指定的实例建立会话。在XTYP_REGISTER和XTYP_UNREGISTER事务期间,将特定于实例的服务名称传递给应用程序的动态数据交换(DDE)回调函数。
默认CONVCONTEXT结构的所有成员都被设置为零,除了cb,它指定了结构的大小,iCodePage指定CP_WINANSI(默认代码页)或CP_WINUNICODE,这取决于ANSI或Unicode DdeInitialize函数的版本由客户端应用程序调用。
也可以看看
CONVCONTEXT, DdeConnectList, DdeCreateStringHandle, DdeDisconnect, DdeDisconnectList, DdeInitialize, XTYP_REGISTER, XTYP_UNREGISTER