Función DdeQueryConvInfo (ddeml.h)

Artículo
08/23/2023

Recupera información sobre una transacción de Intercambio dinámico de datos (DDE) y sobre la conversación en la que tiene lugar la transacción.

Sintaxis

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Parámetros

[in] hConv

Tipo: HCONV

Identificador de la conversación.

[in] idTransaction

Tipo: DWORD

Transacción. Para las transacciones asincrónicas, este parámetro debe ser un identificador de transacción devuelto por la función DdeClientTransaction . Para las transacciones sincrónicas, este parámetro debe ser QID_SYNC.

[in, out] pConvInfo

Tipo: PCONVINFO

Puntero a la estructura CONVINFO que recibe información sobre la transacción y la conversación. El miembro cb de la estructura CONVINFO debe especificar la longitud del búfer asignado para la estructura.

Valor devuelto

Tipo: UINT

Si la función se ejecuta correctamente, el valor devuelto es el número de bytes copiados en la estructura CONVINFO .

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

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 no debe liberar un identificador de cadena al que hace referencia la estructura CONVINFO . Si una aplicación debe usar uno de estos identificadores de cadena, debe llamar a la función DdeKeepStringHandle para crear una copia del identificador.

Si el parámetro idTransaction se establece en QID_SYNC, el miembro hUser de la estructura CONVINFO está asociado a la conversación y se puede usar para contener los datos asociados a la conversación. Si idTransaction es el identificador de una transacción asincrónica, el miembro hUser solo está asociado a la transacción actual y solo es válido durante la transacción.

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