Classe IRowsetLocateImpl

Artigo
02/25/2013

Implementa o OLE DB IRowsetLocate interface, 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 o HROW.
MapClass
A unidade de armazenamento para todos os identificadores de linha mantido pelo provedor.
BookmarkKeyType
O tipo de indicador, como um LONG ou uma seqüência de caracteres.Indicadores comuns devem ter um comprimento de pelo menos dois bytes.(Comprimento de byte único é reservado para o OLE DB indicadores padrãoDBBMK_FIRST, DBBMK_LAST, e DBBMK_INVALID.)
BookmarkType
O mecanismo de mapeamento para manter relacionamentos de dados de indicador.
BookmarkMapClass
A unidade de armazenamento para todos os identificadores de linha mantido pelo indicador.

Membros

Métodos de interface

Compare	Compara dois indicadores.
GetRowsAt	Busca linhas começando com a linha especificada por um deslocamento de um indicador.
GetRowsByBookmark	Busca de linhas que correspondem aos indicadores especificados.
Hash	Retorna valores para os indicadores especificados de hash.

Membros de dados

m_rgBookmarks

Uma matriz de indicadores.

Comentários

IRowsetLocateImplé a implementação de modelos OLE DB do IRowsetLocate interface.IRowsetLocateé usada para buscar linhas arbitrárias de um conjunto de linhas.Um conjunto de linhas não implementa essa interface é uma sequential o conjunto de linhas.Quando IRowsetLocate está presente no conjunto de linhas, a coluna 0 é o indicador das linhas; ler esta coluna para obter um valor de indicador que pode ser usado para reposicionar na mesma linha.

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

Para oferecer suporte a OLE DB indicadores em um conjunto de linhas, verifique o conjunto de linhas herdar desta classe.

Para informações sobre como implementar o suporte de indicador, consulte Provedor de suporte para indicadores na Guia do programador do Visual C++ e indicadores na referência OLE DB Programmer na PlatformSDK.