Fonction JetPrereadIndexRanges

Article
06/13/2023

S’applique à : Windows | Windows Server

La fonction JetPrereadIndexRanges préchant les index pour améliorer les performances.

La fonction JetPrereadIndexRanges a été introduite dans le système d’exploitation 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
);

Paramètres

sesid

Contexte de session de base de données à utiliser pour l’appel d’API.

tableid

Tableau sur lequel émettre les préchantes.

rgIndexRanges

Plages de clés à prélire.

cIndexRanges

Nombre de plages de clés à préliser, déterminé par le nombre d’éléments dans rgIndexRanges.

pcRangesPreread

Nombre de plages de clés qui ont été en fait pré-lues.

rgcolumnidPreread

Liste des ID de colonne pour les colonnes à valeur longue à prélire. Par défaut, seul l’enregistrement sur la page est préllé. Si les colonnes de valeurs longues hors page doivent être préluquées, leurs ID de colonne doivent être passés via ce paramètre.

ccolumnidPreread

Nombre d’ID de colonne pour les colonnes à valeur longue à prélire, déterminé par le nombre d’éléments dans rgcolumnidPreread.

grbit

Groupe de bits qui spécifie zéro ou plus des valeurs de direction de prélecture répertoriées dans le tableau suivant.

Valeur	Signification
Transférer	Prélectez vers l’avant.
Vers l'arrière	Prélectez vers l’arrière.
FirstPageOnly	Prélectez uniquement la première page d’une colonne longue.
NormalizedKey	Clé/signet normalisé fourni au lieu de la valeur de colonne.

Valeur retournée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour répertoriés dans le tableau suivant. Pour plus d’informations sur les erreurs possibles du moteur de stockage extensible (ESE), consultez Erreurs du moteur de stockage extensible et paramètres de gestion des erreurs.

Code de retour	Description
JET_errSuccess	L’opération s’est terminée avec succès.

Notes

Si les enregistrements avec les plages de clés spécifiées ne se trouvent pas dans le cache de mémoire tampon, vous devez démarrer des lectures asynchrones pour les placer dans le cache de mémoire tampon de base de données.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows 8.
Serveur	Nécessite Windows Server 2012.
En-tête	Déclaré dans Esent.h.
Bibliothèque	Utilisez ESENT.lib.
DLL	Nécessite ESENT.dll.

Voir aussi

JET_ERR

Partager via