Función DdeConnectList (ddeml.h)

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

Consulte también

CONVCONTEXT

Conceptual

DdeConnect

DdeCreateStringHandle

DdeDisconnect

DdeDisconnectList

DdeInitialize

DdeQueryNextServer

Biblioteca de administración dinámica de Intercambio de datos

Referencia