Fonction JetInit2

S’applique à : Windows | Windows Server

Fonction JetInit2

La fonction JetInit2 place le moteur de base de données dans un état où il peut prendre en charge l’utilisation des fichiers de base de données par l’application. Le moteur doit déjà être correctement configuré pour l’initialisation à l’aide de JetSetSystemParameter. La récupération sur incident de base de données est effectuée automatiquement dans le cadre du processus d’initialisation.

Windows XP:JetInit2 est introduit dans Windows XP.

Cette fonction est obsolète. Utilisez JetInit3 à la place.

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

Paramètres

pinstance

Instance à utiliser pour cet appel.

Pour Windows 2000, ce paramètre est ignoré et doit toujours être NULL.

Pour Windows XP et versions ultérieures, l’utilisation de ce paramètre dépend du mode de fonctionnement du moteur. Si le moteur fonctionne en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge, ce paramètre peut être NULL ou être défini sur une mémoire tampon de sortie valide contenant NULL ou JET_instanceNil qui retourne le handle de instance global créé en tant qu’effet secondaire de l’initialisation. Ce handle instance peut ensuite être passé à n’importe quelle autre API qui prend une instance. Si le moteur fonctionne en mode multi-instance, ce paramètre doit être défini sur une mémoire tampon d’entrée valide qui contient le handle de instance retourné par jetCreateInstance en cours d’initialisation.

grbit

Groupe de bits spécifiant zéro ou plusieurs des options suivantes.

Valeur	Signification
JET_bitReplayReplicatedLogFiles	Réservé pour un usage futur.
JET_bitCreateSFSVolumeIfNotExist	Réservé pour un usage futur.
JET_bitReplayIgnoreMissingDB	Cette option permet à l’utilisateur d’exécuter la récupération sur un ensemble de fichiers journaux, sans que toutes les bases de données soient présentes, qui ont été attachées à un point du jeu de journaux.
JET_bitRecoveryWithoutUndo	Effectuez la récupération, mais arrêtez-vous à la phase Annuler. Cela permet de copier et d’appliquer des journaux de transactions supplémentaires.
JET_bitTruncateLogsAfterRecovery	En cas de récupération réversible réussie, tronquez les fichiers journaux.
JET_bitReplayMissingMapEntryDB	L’entrée de mappage de base de données manquante est au même emplacement par défaut.
JET_bitReplayIgnoreLostLogs	Ignorer les journaux perdus à la fin du flux de journaux. Windows 7:JET_bitReplayIgnoreLostLogs est introduit 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.

Notes

Un instance doit être initialisé avec un appel à JetInit2 avant de pouvoir être utilisé par autre chose que JetSetSystemParameter.

Un instance est détruit par un appel à la fonction JetTerm, même si cette instance n’a jamais été initialisée à l’aide de JetInit. Une instance est l’unité de récupération du moteur de base de données. Il contrôle le cycle de vie de tous les fichiers utilisés pour protéger l’intégrité des données dans un ensemble de fichiers de base de données. Ces fichiers incluent le fichier de point de contrôle et les fichiers journaux des transactions.

Si la récupération s’exécute sur un ensemble de journaux, pour lesquels toutes les bases de données ne sont pas présentes (ce qui renvoie l’erreur JET_errAttachedDatabaseMismatch dans des circonstances normales), et que le client souhaite que la récupération se poursuive malgré les bases de données manquantes, la JET_ bitReplayIgnoreMissingDB est utilisée pour poursuivre la récupération pour les bases de données disponibles.

Pour plus d’informations, consultez la section Remarques dans JetInit .

Spécifications

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

Fichiers du moteur de stockage extensibles
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
Paramètres de ressource