Estructura CONVINFO (ddeml.h)

  • Artículo

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)

Consulte también

CONVCONTEXT

Conceptual

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

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

Referencia