Fonction JetSetTableSequential

S’applique à : Windows | Windows Server

Fonction JetSetTableSequential

La fonction JetSetTableSequential avertit le moteur de base de données que l’application analyse l’index actuel entier qui contient un curseur donné. Par conséquent, les méthodes utilisées pour accéder aux données d’index seront ajustées pour rendre ce scénario aussi rapide que possible.

Windows XP:JetSetTableSequential est introduit dans Windows XP.

    JET_ERR JET_API JetSetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

Paramètres

sesid

Session à utiliser pour cet appel.

tableid

Curseur à utiliser pour cet appel.

grbit

Groupe de bits qui spécifient zéro ou plusieurs des options suivantes.

Valeur	Signification
JET_bitPrereadForward	Cette option est utilisée pour indexer dans la direction vers l’avant. Windows 7:JET_bitPrereadForward est introduit dans Windows 7.
JET_bitPrereadBackward	Cette option permet d’indexer vers l’arrière. Windows 7:JET_bitPrereadBackward est introduit dans Windows 7.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. Pour plus d’informations sur les erreurs ESE possibles, consultez Erreurs du moteur de stockage extensible et Paramètres de gestion des erreurs.

Code de retour	Description
JET_errClientRequestToStopJetService	L’opération ne peut pas se terminer, car toutes les activités sur le instance associées à la session ont été supprimées à la suite d’un appel à JetStopService.
JET_errInstanceUnavailable	L’opération ne peut pas se terminer, car le instance associé à la session a rencontré une erreur irrécupérable qui exige que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. Windows XP : Cette valeur de retour est introduite dans Windows XP.
JET_errNotInitialized	L’opération ne peut pas se terminer, car le instance associé à la session n’a pas encore été initialisé.
JET_errRestoreInProgress	L’opération ne peut pas se terminer, car une opération de restauration est en cours sur le instance associé à la session.
JET_errTermInProgress	L’opération ne peut pas se terminer, car le instance associé à la session est en cours d’arrêt.

Si cette fonction réussit, l’index actuel du curseur est optimisé pour une analyse séquentielle de l’index entier. Aucune modification de l’état de la base de données ne se produira.

Si cette fonction échoue, aucune modification de la configuration du curseur ne se produit. Aucune modification de l’état de la base de données ne se produira.

Notes

Si l’application doit analyser efficacement un sous-ensemble connu d’un index, une optimisation similaire est également effectuée chaque fois qu’une plage d’index est établie à l’aide de JetSetIndexRange. Cette optimisation est disponible uniquement sur Windows XP et les versions ultérieures.

Si l’application doit analyser efficacement un sous-ensemble inconnu d’un index, aucune action ne doit être effectuée. Le moteur peut détecter automatiquement le comportement d’analyse et extrait les données à l’avance. Toutefois, ce comportement n’est pas aussi agressif.

Cette optimisation rendra l’analyse efficace de l’index principal et rendra l’analyse des données d’entrée d’index dans un index secondaire efficace. L’analyse d’un index secondaire n’est pas efficace lors de la récupération des données d’enregistrement. Cela est dû au fait que le moteur n’effectue pas de lecture anticipée sur les données d’enregistrement.

Spécifications

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

Voir aussi

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetIndexRange
JetStopService