Función de devolución de llamada PFNCALLBACK (ddeml.h)

Una función de devolución de llamada definida por la aplicación que se usa con las funciones de la Biblioteca de administración de Exchange de datos dinámicos (DDEML). Procesa transacciones de Intercambio dinámico de datos (DDE). El tipo PFNCALLBACK define un puntero a esta función de devolución de llamada. DdeCallback es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

PFNCALLBACK Pfncallback;

HDDEDATA Pfncallback(
  [in] UINT wType,
  [in] UINT wFmt,
  [in] HCONV hConv,
  [in] HSZ hsz1,
  [in] HSZ hsz2,
  [in] HDDEDATA hData,
  [in] ULONG_PTR dwData1,
  [in] ULONG_PTR dwData2
)
{...}

Parámetros

[in] wType

Tipo: UINT

Tipo de la transacción actual. Este parámetro consta de una combinación de marcas de clase de transacción y marcas de tipo de transacción. En la tabla siguiente se describe cada una de las clases de transacción y se proporciona una lista de los tipos de transacción de cada clase. Para obtener información sobre un tipo de transacción específico, vea la descripción individual de ese tipo en Comentarios.

[in] wFmt

Tipo: UINT

Formato en el que se envían o reciben los datos.

[in] hConv

Tipo: HCONV

Identificador de la conversación asociada a la transacción actual.

[in] hsz1

Tipo: HSZ

Identificador de una cadena. El significado de este parámetro depende del tipo de transacción actual. Para obtener el significado de este parámetro, vea la descripción del tipo de transacción en Comentarios.

[in] hsz2

Tipo: HSZ

Identificador de una cadena. El significado de este parámetro depende del tipo de transacción actual. Para obtener el significado de este parámetro, vea la descripción del tipo de transacción en Comentarios.

[in] hData

Tipo: HDDEDATA

Identificador de los datos DDE. El significado de este parámetro depende del tipo de transacción actual. Para obtener el significado de este parámetro, vea la descripción del tipo de transacción en Comentarios.

[in] dwData1

Tipo: ULONG_PTR

Datos específicos de la transacción. Para obtener el significado de este parámetro, vea la descripción del tipo de transacción en Comentarios.

[in] dwData2

Tipo: ULONG_PTR

Datos específicos de la transacción. Para obtener el significado de este parámetro, vea la descripción del tipo de transacción en Comentarios.

Valor devuelto

Tipo: HDDEDATA

El valor devuelto depende de la clase de transacción. Para obtener más información sobre los valores devueltos, vea descripciones de los tipos de transacción individuales.

Comentarios

XCLASS_BOOL

Una función de devolución de llamada DDE debe devolver TRUE o FALSE cuando termine de procesar una transacción que pertenezca a esta clase. La clase de transacción XCLASS_BOOL consta de los siguientes tipos:

• XTYP_ADVSTART
• XTYP_CONNECT

XCLASS_DATA

Una función de devolución de llamada DDE debe devolver un identificador DDE, el CBR_BLOCK código devuelto o NULL cuando termine de procesar una transacción que pertenezca a esta clase. La clase de transacción XCLASS_DATA consta de los siguientes tipos:

• XTYP_ADVREQ
• XTYP_REQUEST
• XTYP_WILDCONNECT

XCLASS_FLAGS

Una función de devolución de llamada DDE debe devolver DDE_FACK, DDE_FBUSY o DDE_FNOTPROCESSED cuando termine de procesar una transacción que pertenezca a esta clase. La clase de transacción XCLASS_FLAGS consta de los siguientes tipos:

• XTYP_ADVDATA
• XTYP_EXECUTE
• XTYP_POKE

XCLASS_NOTIFICATION

Los tipos de transacción que pertenecen a esta clase solo son para fines de notificación. Se omite el valor devuelto de la función de devolución de llamada. La clase de transacción XCLASS_NOTIFICATION consta de los siguientes tipos:

• XTYP_ADVSTOP
• XTYP_CONNECT_CONFIRM
• XTYP_DISCONNECT
• XTYP_ERROR
• XTYP_MONITOR
• XTYP_REGISTER
• XTYP_XACT_COMPLETE
• XTYP_UNREGISTER

La función de devolución de llamada se llama de forma asincrónica para las transacciones que no implican la creación o finalización de conversaciones. Una aplicación que no acepta con frecuencia los mensajes entrantes habrá reducido el rendimiento de DDE porque la Biblioteca de administración dinámica de Exchange de datos (DDEML) usa mensajes para iniciar transacciones.

Una aplicación debe registrar la función de devolución de llamada especificando un puntero a la función en una llamada a la función DdeInitialize .

Requisitos

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)

Consulte también

Conceptual

DdeEnableCallback

DdeInitialize

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