Intercambio de campos de registros: Utilizar las funciones de RFX

Artículo
10/07/2008

Actualización: noviembre 2007

Este tema explica cómo usar las llamadas de función RFX que componen el cuerpo de una función de reemplazo de DoFieldExchange.

Nota:
Este tema es aplicable a las clases derivadas de CRecordset donde la obtención masiva de filas no está implementada. 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 mejor estas diferencias, vea Conjunto de registros: obtener registros de forma masiva (ODBC).

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

Sintaxis de las funciones RFX

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

Un puntero a un objeto CFieldExchange. Basta con pasar el puntero pFX pasado a DoFieldExchange.
El nombre de la columna tal como aparece en el origen de datos.
El nombre del miembro de datos de campo o de parámetro correspondiente en la clase de conjunto de registros.
(Opcional) En algunas funciones, la longitud máxima de la cadena o matriz que se está transfiriendo. El valor predeterminado es 255 bytes, pero se puede modificar. El tamaño máximo está basado en el tamaño máximo de un objeto CString: INT_MAX (2.147.483.647) bytes, pero probablemente encontrará límites en el controlador antes de llegar a ese tamaño.
(Opcional) En la función RFX_Text, a veces se utiliza un quinto parámetro para especificar el tipo de datos de una columna.

Para obtener más información, vea las funciones RFX en Macros y funciones globales en la Referencia de la biblioteca de clases. Para obtener un ejemplo de cuándo se 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 varios tipos de datos diferentes entre el origen de datos y los conjuntos de registros. La siguiente lista resume las funciones RFX por tipo de datos. En los casos en que es necesario escribir sus propias llamadas de función RFX, seleccione funciones de esta lista por el 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 las funciones RFX en Macros y funciones globales en la Referencia de la biblioteca de clases. Para obtener más información sobre la correspondencia entre los tipos de datos de SQL y de C++, vea la tabla Correspondencia entre tipos de datos de ANSI SQL y de C++ en SQL: tipos de datos de SQL y C++ (ODBC).