Registros de usuario
Actualización: noviembre 2007
Para usar un descriptor de acceso estático, es decir, derivado de CAccessor), el consumidor debe poseer un registro de usuario. El registro de usuario es una clase de C++ que contiene elementos de datos que controlan la entrada o salida. El Asistente para consumidores OLE DB ATL genera un registro de usuario para nuestro consumidor. Se pueden agregar métodos al registro para realizar tareas opcionales como el control de comandos.
El código siguiente muestra un registro de ejemplo que controla la ejecución de comandos. En el registro de usuario, BEGIN_COLUMN_MAP representa un conjunto de filas de datos pasado al consumidor desde un proveedor. BEGIN_PARAM_MAP representa un conjunto de parámetros de comando. En este ejemplo se usa una clase CCommand para controlar los parámetros de comando. Los miembros de datos de las entradas de mapa representan posiciones de desplazamiento en un bloque contiguo de memoria por cada instancia de la clase. Las macros COLUMN_ENTRY corresponden a las macros PROVIDER_COLUMN_ENTRY del lado del proveedor.
Para obtener más información acerca de las macros COLUMN_MAP y PARAM_MAP, vea Macros para plantillas de consumidor OLE DB.
class CArtists
{
public:
// Data Elements
CHAR m_szFirstName[20];
CHAR m_szLastName[30];
short m_nAge;
// Column binding map
BEGIN_COLUMN_MAP(CArtists)
COLUMN_ENTRY(1, m_szFirstName)
COLUMN_ENTRY(2, m_szLastName)
COLUMN_ENTRY(3, m_nAge)
END_COLUMN_MAP()
// Parameter binding map
BEGIN_PARAM_MAP(CArtists)
COLUMN_ENTRY(1, m_nAge)
END_PARAM_MAP()
};
Registros de usuario generados por el asistente
Si se utiliza el Asistente para consumidores OLE DB ATL para generar un consumidor, se puede elegir entre el uso de plantillas OLE DB o atributos OLE DB. En función de la elección, el código generado es diferente. Para obtener más información acerca del código, vea Clases generadas por el Asistente para consumidores.
Compatibilidad del registro de usuario con múltiples descriptores de acceso
Para obtener información detallada de los escenarios en que es necesario utilizar múltiples descriptores de acceso, vea Utilizar varios descriptores de acceso en un conjunto de filas.
El ejemplo siguiente muestra el registro de usuario modificado para que admita múltiples descriptores de acceso en el conjunto de filas. En lugar de BEGIN_COLUMN_MAP y END_COLUMN_MAP, se utiliza BEGIN_ACCESSOR_MAP y BEGIN_ACCESSOR para cada descriptor de acceso. La macro BEGIN_ACCESSOR especifica el número de descriptor de acceso (desplazamiento respecto a cero) y si el descriptor de acceso es del tipo automático (autoaccessor). Los descriptores de acceso automáticos llaman a GetData para recuperar datos automáticamente en una llamada a MoveNext. Los descriptores de acceso no automáticos requieren recuperar explícitamente los datos. Utilice un descriptor de acceso no automático si crea un enlace con un gran campo de datos (como un mapa de bits) que no desea recuperar en cada registro.
class CMultiArtists
{
public:
// Data Elements
CHAR m_szFirstName[20];
CHAR m_szLastName[30];
short m_nAge;
// Column binding map
BEGIN_ACCESSOR_MAP(CMultiArtists, 2)
BEGIN_ACCESSOR(0, true) // true specifies an auto accessor
COLUMN_ENTRY(1, m_szFirstName)
COLUMN_ENTRY(2, m_szLastName)
END_ACCESSOR()
BEGIN_ACCESSOR(1, false) // false specifies a manual accessor
COLUMN_ENTRY(3, m_nAge)
END_ACCESSOR()
END_ACCESSOR_MAP()
};