JetSetTableSequential fonction)

S’applique à : Windows | Windows Serveurs

JetSetTableSequential fonction)

La fonction JetSetTableSequential avertit le moteur de base de données que l’application analyse l’intégralité de l’index actuel qui contient un curseur donné. Par conséquent, les méthodes utilisées pour accéder aux données d’index seront paramétré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, une ou plusieurs des options suivantes.

Valeur

Signification

JET_bitPrereadForward

Cette option est utilisée pour indexer vers l’avant.

Windows 7 :JET_bitPrereadForward est introduite dans Windows 7.

JET_bitPrereadBackward

Cette option est utilisée pour indexer dans le sens inverse.

Windows 7 :JET_bitPrereadBackward est introduite 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

Impossible d’effectuer l’opération, car toute activité sur l’instance associée à la session a été suspendue suite à un appel à JetStopService.

JET_errInstanceUnavailable

Impossible d’effectuer l’opération, car l’instance associée à la session a rencontré une erreur irrécupérable qui requiert 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

Impossible d’effectuer l’opération, car l’instance associée à la session n’a pas encore été initialisée.

JET_errRestoreInProgress

Impossible de terminer l’opération, car une opération de restauration est en cours sur l’instance associée à la session.

JET_errTermInProgress

L’opération ne peut pas se terminer car l’instance qui est associée à la session est en cours d’arrêt.

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

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 produit.

Remarques

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 de l’analyse et récupérer les données à l’avance. Toutefois, ce comportement n’est pas aussi agressif.

Cette optimisation rendra l’analyse efficace de l’index principal et fera en sorte que l’analyse des données d’entrée d’index dans un index secondaire soit efficace. Il n’effectue pas l’analyse d’un index secondaire pendant 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 de l’enregistrement.

Configuration requise

Condition requise Valeur

Client

requiert Windows Vista ou Windows XP.

Serveur

requiert Windows server 2008 ou Windows server 2003.

En-tête

Déclaré dans esent. h.

Bibliothèque

Utilisez ESENT. lib.

DLL

Requiert ESENT.dll.

Voir aussi

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetIndexRange
JetStopService