IRowsetLocateImpl (Clase)

Implementa la interfaz OLE DB IRowsetLocate , que captura filas arbitrarias de un conjunto de filas.

template <
   class T, 
   class RowsetInterface, 
   class RowClass = CSimpleRow, 
   class MapClass = CAtlMap < RowClass::KeyType, RowClass* >, 
   class BookmarkKeyType = LONG, 
   class BookmarkType = LONG, 
   class BookmarkMapClass = CAtlMap < RowClass::KeyType, RowClass* >
>
class ATL_NO_VTABLE IRowsetLocateImpl : public IRowsetImpl<
   T, 
   RowsetInterface, 
   RowClass, 
   MapClass
>

Parámetros

T
Una clase derivada de IRowsetLocateImpl.
RowsetInterface
Una clase derivada de IRowsetImpl.
RowClass
La unidad de almacenamiento para HROW.
MapClass
La unidad de almacenamiento para los identificadores de fila retenidos por el proveedor.
BookmarkKeyType
El tipo de marcador de posición, como un LONG o una cadena.Los marcadores normales deben tener una longitud por lo menos de dos bytes.(la longitud de un solo byte se reserva para OLE DB marcadores estándarDBBMK_FIRST, DBBMK_LAST, y DBBMK_INVALID.)
BookmarkType
El mecanismo de asignación para las relaciones de los marcador-a-datos que mantienen.
BookmarkMapClass
La unidad de almacenamiento para los identificadores de fila retenidos por el marcador.

Members

Métodos de interfaz

Comparar	Compara dos marcadores.
GetRowsAt	Obtiene las filas que comienzan con la fila especificada por un desplazamiento de un marcador.
GetRowsByBookmark	Obtiene las filas que coinciden con los marcadores especificados.
Hash	Devuelve los valores hash para los marcadores especificados.

Miembros de datos

m_rgBookmarks

Una matriz de marcadores.

Comentarios

IRowsetLocateImpl es la implementación de las plantillas OLE DB de la interfaz de IRowsetLocate .IRowsetLocate se utiliza para capturar filas arbitrarias de un conjunto de filas.Un conjunto de filas que no implementa esta interfaz es un conjunto de filas de sequential .Cuando IRowsetLocate está presente en un conjunto de filas, la columna 0 es el marcador para las filas; leer esta columna obtendrá un valor de marcador de posición que se puede utilizar para colocar de nuevo a la misma fila.

IRowsetLocateImpl se utiliza para implementar la compatibilidad con marcadores en proveedores.Los marcadores son marcadores (índices en un conjunto de filas) que permite al consumidor para volver rápidamente a una fila, permitiendo acceso a los datos de alta velocidad.El proveedor determina qué marcadores pueden identificar de forma única una fila.Mediante los métodos de IRowsetLocateImpl , puede comparar los marcadores, capturar filas por el desplazamiento, capturar filas por el marcador de posición, y devolver valores hash para los marcadores.

Para admitir los marcadores de OLE DB en un conjunto de filas, haga que el conjunto de filas heredan de esta clase.

Para obtener información sobre cómo implementar la compatibilidad con marcadores, vea Compatibilidad del proveedor con los marcadores en La guía del programador de Visual C++ y marcadores en Referencia de El programador de OLE DB en PlatformSDK.