Fonction JetGotoPosition

S’applique à : Windows | Windows Server

Fonction JetGotoPosition

La fonction JetGotoPosition déplace un curseur vers un nouvel emplacement qui est une fraction du chemin de l’index actuel. La fraction est approximativement égale à ce qui suit :

precpos-centriesLT>/precpos-centriesTotal>

Cette opération est effectuée en réponse à l’entrée de zone de défilement de l’utilisateur qui est reçue lorsque l’utilisateur tente d’afficher des données qui démarrent en partie par le biais d’un jeu de données.

    JET_ERR JET_API JetGotoPosition(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_RECPOS* precpos
    );

Paramètres

sesid

Session à utiliser pour cet appel.

tableid

Curseur à utiliser pour cet appel.

précpos

Description de la fraction à utiliser pour positionner le curseur dans l’index actuel.

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_errSuccess	L’opération s’est terminée avec succès.
JET_errClientRequestToStopJetService	L’opération n’a pas pu se terminer, car toutes les activités sur le instance associée à la session ont cessé à la suite d’un appel à JetStopService.
JET_errInstanceUnavailable	L’opération n’a pas pu 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_errInvalidParameter	Le precpos-cbStruct> donné n’est pas une taille valide pour la structure JET_RECPOS , ou precpos-centriesLT> est supérieur à precpos-centriesTotal>.
JET_errNotInitialized	L’opération ne peut pas se terminer, car le instance associé à la session n’a pas encore été initialisé.
JET_errRecordNotFound	Cette erreur est retournée si l’index est vide.
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_errSessionSharingViolation	La même session ne peut pas être utilisée pour plusieurs threads en même temps. Windows XP : Cette valeur de retour est introduite dans Windows XP.
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, le curseur est déplacé vers un enregistrement actif qui est une fraction du chemin à travers l’index où la fraction est precpos-centriesLT> divisé par precpos-centriesTotal>.

Si cette fonction échoue, l’emplacement du curseur reste inchangé.

Notes

Cette opération déplace le curseur à travers la table jusqu’à une position au point approximatif suivant : precpos-centriesLT> divisé par precpos-centriesTotal>.

Lorsque des mises à jour se produisent continuellement sur la table, les appels suivants avec la même JET_RECPOS peuvent déplacer le curseur à différentes positions dans l’index, avant et après la position précédente. L’isolation transactionnelle ne s’applique pas au positionnement via JET_RECPOS , car elle dépend des propriétés physiques de l’index qui ne sont pas isolées par transaction.

JET_RECPOS ne doit pas être utilisé pour décrire un enregistrement dans une table ou pour repositionner un enregistrement proche d’un enregistrement existant. Au lieu de cela, les signets d’un enregistrement existant doivent être récupérés après un JetGotoPosition initial, puis utilisés pour repositionner le même enregistrement.

Spécifications

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

Voir aussi

JET_COLUMNID
JET_ERR
JET_SESID
JET_TABLEID
JET_RECPOS
JET_SETINFO