Intercambio de campos de registros: Utilizar las funciones de RFX

En este tema se explica cómo usar las llamadas de función RFX que componen el cuerpo de la invalidación DoFieldExchange.

Nota:

Este tema se aplica a las clases derivadas de CRecordset en las que no se haya implementado la captura masiva de filas. Si usa la obtención masiva de filas, se implementará el intercambio masivo de campos de registros (RFX masivo). RFX masivo es similar a RFX. Para comprender las diferencias, vea Conjunto de registros: Captura de registros en bloque (ODBC).

Las funciones globales RFX intercambian datos entre columnas del origen de datos y los miembros de datos de campo del conjunto de registros. Escribe las llamadas a la función RFX en la función miembro DoFieldExchange del conjunto de registros. En este tema se describen brevemente las funciones y se muestran los tipos de datos para los que están disponibles las funciones RFX. La nota técnica 43 describe cómo escribir sus propias funciones RFX para tipos de datos adicionales.

Sintaxis de la función RFX

Cada función RFX toma tres parámetros (y algunas toman un cuarto o quinto parámetro opcional):

• Puntero a un objeto CFieldExchange. Simplemente pase el puntero pFX pasado a DoFieldExchange.

• Nombre de la columna tal como aparece en el origen de datos.

• Nombre del miembro de datos de campo o miembro de datos de parámetro correspondiente en la clase del conjunto de registros.

• (Opcional) En algunas de las funciones, la longitud máxima de la cadena o matriz que se transfiere. Su valor predeterminado es de 255 bytes, pero es posible que desee cambiarlo. El tamaño máximo se basa en el tamaño máximo de un objeto CString —INT_MAX (2.147.483.647) bytes—, pero probablemente encuentre límites de controladores antes de ese tamaño.

• (Opcional) En la función RFX_Text, a veces se usa un quinto parámetro para especificar el tipo de datos de una columna.

Para más información sobre las funciones RFX, vea Macros y variables globales en la referencia de la biblioteca de clases. Para obtener un ejemplo de cuándo puede hacer un uso especial de los parámetros, vea Conjunto de registros: Obtener cálculos SUM y otros resultados agregados (ODBC).

Tipos de datos RFX

La biblioteca de clases proporciona funciones RFX para transferir muchos tipos de datos diferentes entre el origen de datos y los conjuntos de registros. En la lista siguiente se resumen las funciones RFX por tipo de datos. En los casos en los que debe escribir sus propias llamadas de función RFX, seleccione entre estas funciones por tipo de datos.

Función	Tipo de datos
RFX_Bool	BOOL
RFX_Byte	BYTE
RFX_Binary	CByteArray
RFX_Double	double
RFX_Single	float
RFX_Int	int
RFX_Long	long
RFX_LongBinary	CLongBinary
RFX_Text	CString
RFX_Date	CTime

Para obtener más información, vea la documentación de la función RFX en Macros y variables globales en la referencia de la biblioteca de clases. Para obtener información sobre cómo los tipos de datos de C++ se asignan a los tipos de datos de SQL, vea la tabla de tipos de datos ANSI SQL asignados a tipos de datos de C++ en SQL: Tipos de datos de SQL y C++ (ODBC).

Consulte también

Intercambio de campos de registros (RFX)
Intercambio de campos de registros: Funcionamiento de RFX
Conjunto de registros: Parametrizar un conjunto de registros (ODBC)
Conjunto de registros: Enlazar dinámicamente columnas de datos (ODBC)
CRecordset (clase)
CFieldExchange (clase)