CLongBinary (clase)

Simplifica el trabajo con objetos de datos binarios de gran tamaño (a menudo denominados BLOB, u "objetos binarios grandes") en una base de datos.

Sintaxis

class CLongBinary : public CObject

Miembros

Constructores públicos

Nombre	Descripción
CLongBinary::CLongBinary	Construye un objeto CLongBinary.

Miembros de datos públicos

Nombre	Descripción
CLongBinary::m_dwDataLength	Contiene el tamaño real en bytes del objeto de datos cuyo identificador se almacena en m_hData.
CLongBinary::m_hData	Contiene un identificador HGLOBAL de Windows para el objeto de imagen real.

Comentarios

Por ejemplo, un campo de registro de una tabla SQL podría contener un mapa de bits que represente una imagen. Un objeto CLongBinary almacena un objeto de este tipo y realiza un seguimiento de su tamaño.

Nota:

En general, ahora es mejor usar CByteArray junto con la función DFX_Binary. Todavía puede usar CLongBinary, pero en general CByteArray proporciona más funcionalidad en Win32, ya que ya no hay la limitación de tamaño que se plantea con CByteArray de 16 bits. Este consejo se aplica a la programación con objetos de acceso a datos (DAO), así como a la conectividad abierta de bases de datos (ODBC).

Para usar un objeto CLongBinary, declare un miembro de datos de campo de tipo CLongBinary en la clase recordset. Este miembro será un miembro insertado de la clase recordset y se construirá cuando se construya el conjunto de registros. Una vez construido el objeto CLongBinary, el mecanismo de intercambio de campos de registro (RFX) carga el objeto de datos desde un campo del registro actual en el origen de datos y lo almacena de nuevo en el registro cuando este se actualiza. RFX consulta el tamaño del objeto binario grande al origen de datos, le asigna almacenamiento (a través del miembro de datos m_hData del objeto CLongBinary) y almacena un identificador HGLOBAL para los datos de m_hData. RFX también almacena el tamaño real del objeto de datos en el miembro de datos m_dwDataLength. Trabaje con los datos del objeto a través de m_hData, utilizando las mismas técnicas que normalmente usaría para manipular los datos almacenados en un identificador HGLOBAL de Windows.

Al destruir el conjunto de registros, el objeto CLongBinary insertado también se destruye y su destructor desasigna el identificador de datos HGLOBAL.

Para más información sobre los objetos grandes y el uso de CLongBinary, vea los artículos Conjunto de registros (ODBC) y Conjunto de registros: utilización de elementos de datos grandes (ODBC).

Jerarquía de herencia

CObject

CLongBinary

Requisitos

Encabezado: afxdb_.h

CLongBinary::CLongBinary

Construye un objeto CLongBinary.

CLongBinary();

CLongBinary::m_dwDataLength

Almacena el tamaño real en bytes de los datos almacenados en el identificador HGLOBAL en m_hData.

SQLULEN m_dwDataLength;

Comentarios

Este tamaño puede ser menor que el tamaño del bloque de memoria asignado para los datos. Llame a la función GLobalSize de Win32 para obtener el tamaño asignado.

CLongBinary::m_hData

Almacena un identificador HGLOBAL de Windows en los datos de objetos binarios grandes reales.

HGLOBAL m_hData;

Consulte también

CObject (clase)
Gráfico de jerarquías
CRecordset (clase)