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