Função JetPrereadIndexRanges

Aplica-se a: Windows | Windows Server

A função JetPrereadIndexRanges pré-analisa índices para melhorar o desempenho.

A função JetPrereadIndexRanges foi introduzida no sistema operacional Windows 8.

JET_ERR JetPrereadIndexRanges(
  __in          const JET_SESID sesid,
  __in          const JET_TABLEID tableid,
  __in_ecount(cIndexRanges)  const JET_INDEX_RANGE* const rgIndexRanges,
  __in          const unsigned long cIndexRanges,
  __out_opt     unsigned long* const pcRangesPreread,
  __in_ecount(ccolumnidPreread)  const JET_COLUMNID* const rgcolumnidPreread,
  __in          const unsigned long ccolumnidPreread,
  __in          const JET_GRBIT grbit
);

Parâmetros

sesid

O contexto de sessão de banco de dados a ser usado para a chamada à API.

Tableid

A tabela em que os pré-lidos são emitidos.

rgIndexRanges

Os intervalos de chaves a serem lidos previamente.

cIndexRanges

O número de intervalos de chaves a serem pré-lidos, determinado pelo número de elementos em rgIndexRanges.

pcRangesPreread

O número de intervalos de chaves que foram, na verdade, pré-lidos.

rgcolumnidPreread

Lista de IDs de coluna para colunas de valor longo a serem pré-lidas. Por padrão, somente o registro na página é pré-lido. Se as colunas de valor longo fora da página precisarem ser pré-lidas, suas IDs de coluna precisarão ser passadas por meio desse parâmetro.

ccolumnidPreread

O número de IDs de coluna para colunas de valor longo a serem pré-lidas, determinado pelo número de elementos em rgcolumnidPreread.

grbit

Um grupo de bits que especifica zero ou mais dos valores de direção pré-lidos listados na tabela a seguir.

Valor	Significado
Encaminhar	Pré-lido para frente.
Ao contrário	Pré-lido para trás.
FirstPageOnly	Pré-ler somente a primeira página de qualquer coluna longa.
NormalizedKey	Chave/indicador normalizado fornecido em vez do valor da coluna.

Valor retornado

Essa função retorna o tipo de dados JET_ERR com um dos códigos de retorno listados na tabela a seguir. Para obter mais informações sobre os possíveis erros do ESE (Mecanismo de Armazenamento Extensível), consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Código de retorno	Descrição
JET_errSuccess	A operação foi concluída com sucesso.

Comentários

Se os registros com os intervalos de chaves especificados não estiverem no cache de buffer, você deverá iniciar leituras assíncronas para trazer os registros para o cache do buffer de banco de dados.

Requisitos

Requisito	Valor
Cliente	Requer Windows 8.
Servidor	Requer Windows Server 2012.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.

Confira também

JET_ERR