Función DdeConnect (ddeml.h)

Artículo
08/23/2023

Establece una conversación con una aplicación de servidor que admite el nombre de servicio y el par de nombres de tema especificados. Si existe más de un servidor de este tipo, el sistema solo selecciona uno.

Sintaxis

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [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. Este identificador debe haber sido creado por una llamada anterior a la función DdeCreateStringHandle . Si este parámetro es 0L, se establece una conversación con cualquier servidor disponible.

[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 DdeCreateStringHandle. Si este parámetro es 0L, se establece una conversación en cualquier tema admitido por el servidor seleccionado.

[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: HCONV

Si la función se ejecuta correctamente, el valor devuelto es el identificador de la conversación establecida.

Si se produce un error en la función, el valor devuelto es 0L.

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

Comentarios

La aplicación cliente no puede hacer suposiciones con respecto al servidor seleccionado. Si se especifica un nombre específico de instancia en el parámetro hszService , se establece una conversación solo con la instancia especificada. Los nombres de servicio específicos de la instancia se pasan a la función de devolución de llamada de Intercambio de datos dinámicos (DDE) de una aplicación durante las transacciones de XTYP_REGISTER y XTYP_UNREGISTER .

Todos los miembros de la estructura CONVCONTEXT predeterminada se establecen en cero excepto cb, que especifica el tamaño de la estructura y iCodePage, que especifica 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