JetResetTableSequential, fonction

S’applique à : Windows | serveur Windows

JetResetTableSequential, fonction

La fonction JetResetTableSequential informe le moteur de base de données que l’application n’analyse plus l’index actuel entier contenant un curseur donné. Cet appel inverse une notification envoyée par JetSetTableSequential.

Windows XP:JetResetTableSequential est introduit dans Windows XP.

    JET_ERR JET_API JetResetTableSequential(
      __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

Réservé pour un usage futur.

Valeur de retour

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 extensible Stockage s etparamètres de gestion des erreurs.

Code de retour

Description

JET_errSuccess

L’opération s’est terminée avec succès.

JET_errClientRequestToStopJetService

Il n’est pas possible de terminer l’opération, car toute activité sur l’instance associée à la session a cessé en raison d’un appel à JetStopService.

JET_errInstanceUnavailable

Il n’est pas possible d’effectuer l’opération, car l’instance associée à la session a rencontré une erreur irrécupérable qui nécessite que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. Cette erreur ne sera retournée que par Windows XP et versions ultérieures.

JET_errNotInitialized

Il n’est pas possible de terminer l’opération, car l’instance associée à la session n’a pas encore été initialisée.

JET_errRestoreInProgress

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

JET_errTermInProgress

Il n’est pas possible d’effectuer l’opération, car l’instance associée à la session est arrêtée.

En cas de réussite, l’index actuel du curseur n’est plus optimisé pour une analyse séquentielle de l’index entier. Aucune modification de l’état de la base de données ne se produit.

En cas d’échec, aucune modification de la configuration du curseur ne se produit. Aucune modification de l’état de la base de données ne se produit.

Notes

Il est sûr d’effectuer cet appel par rapport à un curseur qui n’a pas été précédemment configuré par un appel à JetSetTableSequential.

Configuration requise

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
JetSetTableSequential
JetStopService