Classe IRowsetLocateImpl

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

Sintaxe

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 do HROW.

MapClass
A unidade de armazenamento para todos os identificadores de linha mantidos pelo provedor.

BookmarkKeyType
O tipo do indicador, como um LONG ou uma cadeia de caracteres. Indicadores comuns precisam ter um comprimento de pelo menos dois bytes. (O comprimento de byte único é reservado para os indicadores padrãoDBBMK_FIRST OLE DB, DBBMK_LAST e DBBMK_INVALID.)

BookmarkType
O mecanismo de mapeamento para manter relações de indicadores para dados.

BookmarkMapClass
A unidade de armazenamento para todos os identificadores de linha mantidos pelo indicador.

Requisitos

Cabeçalho: atldb.h

Membros

Métodos de interface

Membros de dados

Comentários

IRowsetLocateImpl é a implementação de Modelos OLE DB da interface IRowsetLocate. IRowsetLocate é usado para buscar linhas arbitrárias de um conjunto de linhas. Um conjunto de linhas que não implementa essa interface é um conjunto de linhas sequential. Quando IRowsetLocate estiver presente em um conjunto de linhas, a coluna 0 será o indicador para as linhas; a leitura dessa coluna obterá um valor de indicador que poderá ser usado para reposicionar para a mesma linha.

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

Para dar suporte a indicadores 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 a indicadores, confira Suporte do provedor a indicadores no Guia do Programador do Visual C++ e Indicadores na Referência de programador do OLE DB no SDK da Plataforma.

IRowsetLocateImpl::Compare

Compara dois indicadores.

Sintaxe

STDMETHOD (Compare )(HCHAPTER /* hReserved */,
   DBBKMARK cbBookmark1,
   const BYTE* pBookmark1,
   DBBKMARK cbBookmark2,
   const BYTE* pBookmark2,
   DBCOMPARE* pComparison);

Parâmetros

Confira IRowsetLocate::Compare na Referência do programador OLE DB.

Comentários

Qualquer um dos indicadores pode ser um indicador padrão definido pelo OLE DB (DBBMK_FIRST, DBBMK_LAST ou DBBMK_INVALID). O valor retornado em pComparison indica a relação entre os dois indicadores:

• DBCOMPARE_LT (cbBookmark1 é antes de cbBookmark2.)

• DBCOMPARE_EQ (cbBookmark1 é igual a cbBookmark2.)

• DBCOMPARE_LT (cbBookmark1 é após cbBookmark2.)

• DBCOMPARE_NE (os indicadores são iguais e não são ordenados.)

• DBCOMPARE_NOTCOMPARABLE (os indicadores não podem ser comparados.)

IRowsetLocateImpl::GetRowsAt

Busca linhas, iniciando com a linha especificada por um deslocamento de um indicador.

Sintaxe

STDMETHOD (GetRowsAt )(HWATCHREGION /* hReserved1 */,
   HCHAPTER hReserved2,
   DBBKMARK cbBookmark,
   const BYTE* pBookmark,
   DBROWOFFSET lRowsOffset,
   DBROWCOUNT cRows,
   DBCOUNTITEM* pcRowsObtained,
   HROW** prghRows);

Parâmetros

Confira IRowsetLocate::GetRowsAt na Referência do programador OLE DB.

Comentários

Para buscar a partir da posição do cursor, use IRowset::GetRowsAt.

IRowsetLocateImpl::GetRowsAt não altera a posição do cursor.

IRowsetLocateImpl::GetRowsByBookmark

Busca uma ou mais linhas que correspondem aos indicadores especificados.

Sintaxe

STDMETHOD (GetRowsByBookmark )(HCHAPTER /* hReserved */,
   DBCOUNTITEM cRows,
   const DBBKMARK rgcbBookmarks[],
   const BYTE* rgpBookmarks,
   HROW rghRows[],
   DBROWSTATUS* rgRowStatus[]);

Parâmetros

hReserved
[in] Corresponde ao parâmetro hChapter para IRowsetLocate::GetRowsByBookmark.

Para outros parâmetros, confira IRowsetLocate::GetRowsByBookmark na Referência do Programador OLE DB.

Comentários

O indicador pode ser um valor que você define ou um indicador padrão OLE DB (DBBMK_FIRST ou DBBMK_LAST). Não altera a posição do cursor.

IRowsetLocateImpl::Hash

Retorna valores de hash para os indicadores especificados.

Sintaxe

STDMETHOD (Hash )(HCHAPTER /* hReserved */,
   DBBKMARK cbBookmarks,
   const DBBKMARK* rgcbBookmarks[],
   const BYTE* rgpBookmarks[],
   DBHASHVALUE rgHashValues[],
   DBROWSTATUS rgBookmarkStatus[]);

Parâmetros

hReserved
[in] Corresponde ao parâmetro hChapter para IRowsetLocate::Hash.

Para outros parâmetros, confira IRowsetLocate::Hash na Referência do Programador OLE DB.

IRowsetLocateImpl::m_rgBookmarks

Uma matriz de indicadores.

Sintaxe

CAtlArray<DBROWCOUNT> m_rgBookmarks;

Confira também

Modelos de Provedor OLE DB
Arquitetura de modelo do provedor do OLE DB
IRowsetLocate:IRowsetSuporte do provedor para indicadores
Indicadores