Funzione JetPrereadIndexRanges

Articolo
06/13/2023

Si applica a: Windows | Windows Server

La funzione JetPrereadIndexRanges prereada gli indici per migliorare le prestazioni.

La funzione JetPrereadIndexRanges è stata introdotta nel sistema operativo 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
);

Parametri

sesid

Contesto della sessione di database da usare per la chiamata API.

tableid

Tabella in cui eseguire i preread.

rgIndexRanges

Intervalli di chiavi da prereadre.

cIndexRanges

Numero di intervalli di chiavi da prereadre, determinato dal numero di elementi in rgIndexRanges.

pcRangesPreread

Numero di intervalli di chiavi effettivamente preread.

rgcolumnidPreread

Elenco di ID di colonna per le colonne con valore lungo da prereadre. Per impostazione predefinita, solo il record nella pagina è preread. Se è necessario prereadre le colonne con valori lunghi all'esterno della pagina, è necessario passare gli ID di colonna tramite questo parametro.

ccolumnidPreread

Numero di ID di colonna per le colonne con valore lungo da prereadre, determinato dal numero di elementi in rgcolumnidPreread.

grbit

Gruppo di bit che specifica zero o più valori di direzione preread elencati nella tabella seguente.

Valore	Significato
Inoltra	Preread forward.
Indietro	Preread indietro.
FirstPageOnly	Preread solo la prima pagina di qualsiasi colonna lunga.
NormalizedKey	Chiave/segnalibro normalizzati forniti invece del valore della colonna.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti elencati nella tabella seguente. Per altre informazioni sui possibili errori di Extensible Storage Engine (ESE), vedere Extensible Storage Engine Errors and Error Handling Parameters .For more information about the possible Extensible Storage Engine errors( ESE), see Extensible Storage Engine Errors and Error Handling Parameters.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.

Commenti

Se i record con gli intervalli di chiavi specificati non si trovano nella cache del buffer, è necessario avviare letture asincrone per inserire i record nella cache del buffer del database.

Requisiti

Requisito	Valore
Client	Richiede Windows 8.
Server	Richiede Windows Server 2012.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.

Vedi anche

JET_ERR

Condividi tramite