| 术语 | ddeconnectlist |
| 释义 | DdeConnectList 语法： HCONVLIST DdeConnectList( DWORD idInst, HSZ hszService, HSZ hszTopic, HCONVLIST hConvList, PCONVCONTEXT pCC ); DdeConnectList功能 该DdeConnectList函数建立一个与所有服务器应用程序会话的支持指定的服务名称和主题名称对。应用程序也可以使用此功能，以获取会话列表处理函数传递一个现有的会话处理。动态数据交换管理库中删除处理从会话列表中的任何终止交谈。由此产生的对话列表包含所有目前设立的谈话处理，支持指定的服务名称和主题名称。 参数 idInst [in]指定的应用程序实例标识符先前调用DdeInitialize函数获得。 hszService [in]句柄字符串指定的服务器应用程序的谈话将设立服务名称。如果此参数0L，系统尝试建立与所有可用的服务器会话，支持指定的主题名称。 hszTopic [in]句柄字符串，指定专题对话上要成立时名称。这种处理，必须是被以前的调用DdeCreateStringHandle函数创建。如果此参数0L，系统将尝试建立由选定的服务器(或服务器支持的所有议题的谈话)。 hConvList [in]句柄谈话清单列举。此参数应当0L如果一个新的会话列表要成立。 政协 [in]指向CONVCONTEXT结构，它包含交谈上下文信息。如果该参数为NULL，服务器收到在XTYP_CONNECT或XTYP_WILDCONNECT交易默认CONVCONTEXT结构。 Windows 95/98/Me的：如果使用Unicode，那么iCodePage成员可以指定CP_WINUNICODE微软层。 返回值 如果函数成功，返回值是处理到一个新的会话列表。 如果函数失败，返回值是0L。在处理旧的会话列表不再有效。 该DdeGetLastError函数可用于获得错误代码，它可以是下列值之一： DMLERR_DLL_NOT_INITIALIZED DMLERR_INVALID_PARAMETER DMLERR_NO_CONV_ESTABLISHED DMLERR_NO_ERROR DMLERR_SYS_ERROR 备注 应用程序必须释放会话列表处理由DdeConnectList函数返回，不管是否在列表中的谈话是积极的处理。要释放的处理，应用程序可以调用DdeDisconnectList。 默认的CONVCONTEXT结构的所有成员都设置为零，除非文件，指定的结构尺寸和iCodePage，指定CP_WINANSI(默认代码页)，或CP_WINUNICODE，是否ANSI或Unicode的DdeInitialize功能所要求的版本而定客户端应用程序。 在Windows 95/98/Me：DdeConnectList是支持微软层对于Unicode。要使用此，您必须将某些文件到您的应用，概述了对Unicode的Microsoft层在Windows 95/98/Me系统。 功能信息 最低DLL版本 user32.dll 在Ddeml.h HeaderDeclared，头文件：winuser.h import libraryUser32.lib 最低操作系统Windows 95，Windows NT 3.1 参见 动态数据交换管理库概况，CONVCONTEXT，DdeConnect，DdeCreateStringHandle，DdeDisconnect，DdeDisconnectList，DdeInitialize，DdeQueryNextServer ＝＝英文原文＝＝DdeConnectList Function The DdeConnectList function establishes a conversation with all server applications that support the specified service name and topic name pair. An application can also use this function to obtain a list of conversation handles by passing the function an existing conversation handle. The Dynamic Data Exchange Management Library removes the handles of any terminated conversations from the conversation list. The resulting conversation list contains the handles of all currently established conversations that support the specified service name and topic name. Syntax HCONVLIST DdeConnectList( DWORD idInst, HSZ hszService, HSZ hszTopic, HCONVLIST hConvList, PCONVCONTEXT pCC ); Parameters idInst [in] Specifies the application instance identifier obtained by a previous call to the DdeInitialize function. hszService [in] Handle to the string that specifies the service name of the server application with which a conversation is to be established. If this parameter is 0L, the system attempts to establish conversations with all available servers that support the specified topic name. hszTopic [in] Handle to the string that specifies the name of the topic on which a conversation is to be established. This handle must have been created by a previous call to the DdeCreateStringHandle function. If this parameter is 0L, the system will attempt to establish conversations on all topics supported by the selected server (or servers). hConvList [in] Handle to the conversation list to be enumerated. This parameter should be 0L if a new conversation list is to be established. pCC [in] Pointer to the CONVCONTEXT structure that contains conversation-context information. If this parameter is NULL, the server receives the default CONVCONTEXT structure during the XTYP_CONNECT or XTYP_WILDCONNECT transaction. Windows 95/98/Me: If using the Microsoft Layer for Unicode , the iCodePage member can specify CP_WINUNICODE. Return Value If the function succeeds, the return value is the handle to a new conversation list. If the function fails, the return value is 0L. The handle to the old conversation list is no longer valid. The DdeGetLastError function can be used to get the error code, which can be one of the following values: DMLERR_DLL_NOT_INITIALIZED DMLERR_INVALID_PARAMETER DMLERR_NO_CONV_ESTABLISHED DMLERR_NO_ERROR DMLERR_SYS_ERROR Remarks An application must free the conversation list handle returned by the DdeConnectList function, regardless of whether any conversation handles within the list are active. To free the handle, an application can call DdeDisconnectList . All members of the default CONVCONTEXT structure are set to zero except cb, specifying the size of the structure, and iCodePage, specifying CP_WINANSI (the default code page) or CP_WINUNICODE, depending on whether the ANSI or Unicode version of the DdeInitialize function was called by the client application. Windows 95/98/Me: DdeConnectList is supported by the Microsoft Layer for Unicode. To use this, you must add certain files to your application, as outlined in Microsoft Layer for Unicode on Windows 95/98/Me Systems. Function Information Minimum DLL Versionuser32.dll HeaderDeclared in Ddeml.h, include Windows.h Import libraryUser32.lib Minimum operating systemsWindows 95, Windows NT 3.1 See Also Dynamic Data Exchange Management Library Overview , CONVCONTEXT , DdeConnect , DdeCreateStringHandle , DdeDisconnect , DdeDisconnectList , DdeInitialize , DdeQueryNextServer ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/ms648746(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。