Función DdeConnectList (ddeml.h)

Artículo
03/05/2024

Establece una conversación con todas las aplicaciones de servidor que admiten el nombre de servicio y el par de nombres de tema especificados. Una aplicación también puede usar esta función para obtener una lista de identificadores de conversación pasando la función un identificador de conversación existente. La biblioteca de administración dinámica de Exchange de datos quita los identificadores de las conversaciones terminadas de la lista de conversaciones. La lista de conversaciones resultante contiene los identificadores de todas las conversaciones establecidas actualmente que admiten el nombre de servicio y el nombre del tema especificados.

Sintaxis

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [in, optional] PCONVCONTEXT pCC
);

Parámetros

[in] idInst

Tipo: DWORD

Identificador de instancia de aplicación obtenido por una llamada anterior a la función DdeInitialize .

[in] hszService

Tipo: HSZ

Identificador de la cadena que especifica el nombre de servicio de la aplicación de servidor con la que se va a establecer una conversación. Si este parámetro es 0L, el sistema intenta establecer conversaciones con todos los servidores disponibles que admiten el nombre de tema especificado.

[in] hszTopic

Tipo: HSZ

Identificador de la cadena que especifica el nombre del tema en el que se va a establecer una conversación. Este identificador debe haber sido creado por una llamada anterior a la función DdeCreateStringHandle . Si este parámetro es 0L, el sistema intentará establecer conversaciones en todos los temas admitidos por el servidor seleccionado (o servidores).

[in] hConvList

Tipo: HCONVLIST

Identificador de la lista de conversaciones que se va a enumerar. Este parámetro debe ser 0L si se va a establecer una nueva lista de conversaciones.

[in, optional] pCC

Tipo: PCONVCONTEXT

Puntero a la estructura CONVCONTEXT que contiene información de contexto de conversación. Si este parámetro es NULL, el servidor recibe la estructura CONVCONTEXT predeterminada durante la transacción XTYP_CONNECT o XTYP_WILDCONNECT .

Valor devuelto

Tipo: HCONVLIST

Si la función se ejecuta correctamente, el valor devuelto es el identificador de una nueva lista de conversaciones.

Si se produce un error en la función, el valor devuelto es 0L. El identificador de la lista de conversaciones antigua ya no es válido.

La función DdeGetLastError se puede usar para obtener el código de error, que puede ser uno de los siguientes valores:

Comentarios

Una aplicación debe liberar el identificador de lista de conversaciones devuelto por la función DdeConnectList , independientemente de si hay algún identificador de conversación dentro de la lista activo. Para liberar el identificador, una aplicación puede llamar a DdeDisconnectList.

Todos los miembros de la estructura CONVCONTEXT predeterminada se establecen en cero excepto cb, especificando el tamaño de la estructura y iCodePage, especificando CP_WINANSI (la página de códigos predeterminada) o CP_WINUNICODE, dependiendo de si la versión ANSI o Unicode de la función DdeInitialize la llamó la aplicación cliente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ddeml.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll