Classe IRowsetLocateImpl

Artigo
06/10/2015

Implementa a interface OLE DB IRowsetLocate , que busca linhas arbitrárias de um conjunto de linhas.

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
Uma classe derivada de IRowsetLocateImpl.
RowsetInterface
Uma classe derivada de IRowsetImpl.
RowClass
A unidade de armazenamento para HROW.
MapClass
A unidade de armazenamento para todas as alças de linha mantidos pelo provedor.
BookmarkKeyType
O tipo de medidor, como um LONG ou uma cadeia de caracteres. Os indicadores similares devem ter um comprimento de pelo menos dois bytes. (comprimento de byte único é reservado para OLE DB indicadores padrãoDBBMK_FIRST, DBBMK_LAST, e DBBMK_INVALID.)
BookmarkType
O mecanismo de mapeamento para relações de manutenção de indicador-à- dados.
BookmarkMapClass
A unidade de armazenamento para todas as alças de linha mantidos pelo indicador.

Membros

Métodos da interface

Comparar	Compara dois medidores.
GetRowsAt	Buscar linhas iniciar com a linha especificada por um deslocamento de um indicador.
GetRowsByBookmark	Pesquisa linhas que correspondam aos indicadores especificados.
Hash	Retorna valores de hash dos indicadores especificados.

Membros de dados

m_rgBookmarks

Uma matriz de indicadores.

Comentários

IRowsetLocateImpl é a implementação de modelos OLE DB da interface de IRowsetLocate . IRowsetLocate é usado para buscar linhas arbitrárias de um conjunto de linhas. Um conjunto de linhas que não implementa esta interface é um conjunto de linhas de sequential . Quando IRowsetLocate presentes em um conjunto de linhas, a coluna 0 é o indexador das linhas; leia esta coluna terá um valor do medidor que pode ser usado para reposicionar à mesma linha.

IRowsetLocateImpl é usado para implementar o suporte do medidor em provedores. Os indicadores são espaços reservados (índices em um conjunto de linhas) que habilita o consumidor para retornar rapidamente em uma linha, permitindo o acesso aos dados em alta velocidade. O provedor determina que os indicadores podem identificar uma linha. Usando métodos de IRowsetLocateImpl , você pode comparar indicadores, buscar linhas pelo deslocamento, buscar linhas por indicador, e retornam valores de hash de indicadores.

Para oferecer suporte a indicadores do OLE DB em um conjunto de linhas, faça o conjunto de linhas herdar dessa classe.

Para obter informações sobre como implementar o suporte do medidor, consulte Suporte do provedor para indicadores em Visual C++ Programmer's Guide e Indicadores em OLE DB Programmer's Reference emPlatformSDK.