Partager via

Fonction JetIdle

  • Article

S’applique à : Windows | Windows Server

Fonction JetIdle

La fonction JetIdle est obsolète et ne doit être utilisée qu’à des fins de test. JetIdle peut être utilisé pour effectuer des tâches de nettoyage inactifs ou case activée le magasin de versions status dans ESE.

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Paramètres

sesid

Session qui sera utilisée pour cet appel.

grbit

Groupe de bits qui contient les options à utiliser pour cet appel, qui incluent zéro ou plusieurs des bits suivants :

Valeur

Signification

JET_bitIdleCompact

Déclenche le nettoyage du magasin de versions.

JET_bitIdleFlushBuffers

Réservé pour un usage futur. Si cet indicateur est spécifié, l’API retourne JET_errInvalidgrbit.

JET_bitIdleStatus

Retourne JET_wrnIdleFull si le magasin de versions est saturé à plus de moitié.

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_errInvalidParameter

Un paramètre grbit fourni à l’API n’était pas valide.

Si cette fonction réussit, l’opération appropriée est déclenchée ou un code d’erreur indiquant à quel point le magasin de versions est saturé en fonction du grbit fourni.

Si cette fonction échoue, l’opération demandée ne s’est pas terminée avec succès.

Notes

Le magasin de versions gère le mécanisme d’isolation instantané d’ESE. Si le magasin de versions est plus de la moitié plein, le programme peut fermer les transactions de longue durée. Si une transaction de longue durée épuise le magasin de versions, ESE cesse d’autoriser les opérations d’écriture dans la base de données.

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_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction