DdeConnect

【勇芳软件工作室】汉化HomePreviousNext

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_REGISTERXTYP_UNREGISTER事务期间,将特定于实例的服务名称传递给应用程序的动态数据交换(DDE)回调函数。

默认CONVCONTEXT结构的所有成员都被设置为零,除了cb,它指定了结构的大小,iCodePage指定CP_WINANSI(默认代码页)或CP_WINUNICODE,这取决于ANSI或Unicode DdeInitialize函数的版本由客户端应用程序调用。

也可以看看

CONVCONTEXT, DdeConnectList, DdeCreateStringHandle, DdeDisconnect, DdeDisconnectList, DdeInitialize, XTYP_REGISTER, XTYP_UNREGISTER