Estructura CONVINFO (ddeml.h)

Artículo
08/23/2023

Contiene información sobre una conversación de intercambio dinámico de datos (DDE).

Sintaxis

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

Miembros

cb

Tipo: DWORD

Tamaño de la estructura, en bytes.

hUser

Tipo: DWORD_PTR

Datos definidos por la aplicación.

hConvPartner

Tipo: HCONV

Identificador de la aplicación asociada en la conversación DDE. Este miembro es cero si el asociado no se ha registrado (mediante la función DdeInitialize ) para realizar llamadas a funciones DDEML. Una aplicación no debe pasar este miembro a ninguna función DDEML excepto DdeQueryConvInfo.

hszSvcPartner

Tipo: HSZ

Identificador del nombre de servicio de la aplicación asociada.

hszServiceReq

Tipo: HSZ

Identificador del nombre de servicio de la aplicación de servidor que se solicitó para la conexión.

hszTopic

Tipo: HSZ

Identificador del nombre del tema solicitado.

hszItem

Tipo: HSZ

Identificador del nombre del elemento solicitado. Este miembro es específico de la transacción.

wFmt

Tipo: UINT

Formato de los datos que se intercambian. Este miembro es específico de la transacción.

wType

Tipo: UINT

Tipo de la transacción actual. Este miembro es específico de la transacción; puede ser uno de los siguientes valores.

Valor	Significado
XTYP_ADVDATA 0x4010	Informa a un cliente que aconseja que haya llegado datos de un servidor.
XTYP_ADVREQ 0x2022	Solicita a un servidor que envíe datos actualizados al cliente durante un bucle de aviso. Esta transacción se produce cuando el servidor llama a DdePostAdvise.
XTYP_ADVSTART 0x1030	Solicita a un servidor que inicie un bucle de aviso con un cliente.
XTYP_ADVSTOP 0x8040	Notifica a un servidor que un bucle de aviso se está deteniendo.
XTYP_CONNECT 0x1062	Solicita a un servidor que establezca una conversación con un cliente.
XTYP_CONNECT_CONFIRM 0x8072	Notifica a un servidor que se ha establecido una conversación con un cliente.
XTYP_DISCONNECT 0x80C2	Notifica a un servidor que ha finalizado una conversación.
XTYP_EXECUTE 0x4050	Solicita a un servidor que ejecute un comando enviado por un cliente.
XTYP_MONITOR 0x80F2	Notifica a una aplicación registrada como APPCMD_MONITOR que se transmiten datos DDE.
XTYP_POKE 0x4090	Solicita a un servidor que acepte datos no solicitados de un cliente.
XTYP_REGISTER 0x80A2	Notifica a otras aplicaciones DDEML que un servidor ha registrado un nombre de servicio.
XTYP_REQUEST 0x20B0	Solicita a un servidor que envíe datos a un cliente.
XTYP_UNREGISTER 0x80D2	Notifica a otras aplicaciones DDEML que un servidor ha anulado el registro de un nombre de servicio.
XTYP_WILDCONNECT 0x20E2	Solicita a un servidor que establezca varias conversaciones con el mismo cliente.
XTYP_XACT_COMPLETE 0x8080	Notifica a un cliente que se ha completado una transacción de datos asincrónica.

wStatus

Tipo: UINT

Estado de la conversación actual. Este miembro puede ser uno o varios de los valores siguientes.

Valor	Significado
ST_ADVISE 0x0002	Uno o varios vínculos están en curso.
ST_BLOCKED 0x0008	La conversación está bloqueada.
ST_BLOCKNEXT 0x0080	La conversación se bloqueará después de llamar a la siguiente devolución de llamada.
ST_CLIENT 0x0010	El identificador con0x0010versation pasado a la función DdeQueryConvInfo es un identificador del lado cliente. Si el identificador es cero, el identificador de conversación que se pasa a la función DdeQueryConvInfo es un identificador del lado servidor.
ST_CONNECTED 0x0001	La conversación está conectada.
ST_INLIST 0x0040	La conversación es miembro de una lista de conversaciones.
ST_ISLOCAL 0x0004	Ambos lados de la conversación usan DDEML.
ST_ISSELF 0x0100	Ambos lados de la conversación usan la misma instancia de DDEML.
ST_TERMINATED 0x0020	El asociado ha terminado la conversación.

wConvst

Tipo: UINT

Estado de la conversación. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
XST_ADVACKRCVD 13	La transacción de aviso acaba de completarse.
XST_ADVDATAACKRCVD 16	La transacción de datos de aviso acaba de completarse.
XST_ADVDATASENT 15	Se han enviado datos de asesoramiento y están esperando una confirmación.
XST_ADVSENT 11	Una transacción de aviso está esperando una confirmación.
XST_CONNECTED 2	La conversación no tiene transacciones activas.
XST_DATARCVD 6	Los datos solicitados se acaban de recibir.
XST_EXECACKRCVD 10	Se acaba de completar una transacción de ejecución.
XST_EXECSENT 9	Una transacción de ejecución está esperando una confirmación.
XST_INCOMPLETE 1	Error en la última transacción.
XST_INIT1 3	Estado 1 de inicio medio.
XST_INIT2 4	Estado de inicio medio 2.
XST_NULL 0	Estado de inicio previo.
XST_POKEACKRCVD 8	Se acaba de completar una transacción poke.
XST_POKESENT 7	Una transacción poke está esperando una confirmación.
XST_REQSENT 5	Una transacción de solicitud está esperando una confirmación.
XST_UNADVACKRCVD 14	Se acaba de completar una transacción novise.
XST_UNADVSENT 12	Una transacción novise está esperando una confirmación.

wLastError

Tipo: UINT

Valor de error asociado a la última transacción.

hConvList

Tipo: HCONVLIST

Identificador de la lista de conversaciones si el identificador de la conversación actual está en una lista de conversaciones. Este miembro es NULL si la conversación no está en una lista de conversaciones.

ConvCtxt

Tipo: CONVCONTEXT

Contexto de conversación.

hwnd

Tipo: HWND

Identificador de la ventana de la aplicación que realiza la llamada implicada en la conversación.

hwndPartner

Tipo: HWND

Identificador de la ventana de la aplicación asociada implicada en la conversación actual.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	ddeml.h (incluya Windows.h)