Partager via

Fonction JetGetLogInfo

S’applique à : Windows | Windows Server

Fonction JetGetLogInfo

La fonction JetGetLogInfo est utilisée lors d’une sauvegarde lancée par JetBeginExternalBackup pour interroger un instance les noms des fichiers correctifs de base de données et des fichiers journaux des transactions qui doivent faire partie de l’ensemble de fichiers de sauvegarde. Ces fichiers peuvent ensuite être ouverts à l’aide de JetOpenFile et lus à l’aide de JetReadFile.

    JET_ERR JET_API JetGetLogInfo(
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Paramètres

szz

Mémoire tampon de sortie qui recevra la liste des chaînes null terminées décrivant l’ensemble des fichiers correctifs de base de données et des fichiers journaux des transactions qui doivent faire partie de l’ensemble de fichiers de sauvegarde.

La liste des chaînes retournées dans cette mémoire tampon est au même format qu’une chaîne multi string utilisée par le Registre. Chaque chaîne terminée par null est retournée dans l’ordre, suivie d’une terminaison null finale.

cbMax

Taille maximale en octets de la mémoire tampon de sortie.

pcbActual

Reçoit la quantité réelle de données de chaîne reçues dans la mémoire tampon de sortie.

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_errBackupAbortByServer

L’opération a échoué, car la sauvegarde externe actuelle a été abandonnée par un appel à JetStopBackup. Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures.

JET_errClientRequestToStopJetService

Il n’est pas possible d’effectuer l’opération, car toutes les activités sur le instance associées à la session ont cessé à la suite d’un appel à JetStopService.

JET_errInstanceUnavailable

Il n’est pas possible d’effectuer l’opération, 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. Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures.

JET_errInvalidBackupSequence

L’opération de sauvegarde a échoué, car elle a été appelée hors séquence. JetGetLogInfo retourne cette erreur s’il existe des handles de fichier en attente créés à l’aide de JetOpenFile pour le instance.

JET_errInvalidParameter

L’un des paramètres fournis contenait une valeur inattendue ou contenait une valeur qui n’était pas logique lorsqu’elle était combinée à la valeur d’un autre paramètre. Cela peut se produire pour JetGetLogInfo lorsque le handle de instance spécifié n’est pas valide (Windows XP et versions ultérieures).

JET_errNoBackup

L’opération a échoué, car aucune sauvegarde externe n’est en cours.

JET_errNotInitialized

Il n’est pas possible d’effectuer l’opération, car le instance associé à la session n’a pas encore été initialisé.

JET_errRestoreInProgress

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

JET_errRunningInMultiInstanceMode

L’opération a échoué car une tentative d’utilisation du moteur a été effectuée en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge alors qu’en fait plusieurs instances existent déjà.

JET_errTermInProgress

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

En cas de réussite, les informations demandées sur l’ensemble des fichiers correctifs de base de données et des fichiers journaux des transactions qui doivent faire partie du jeu de fichiers de sauvegarde seront placées dans les mémoires tampons de sortie, le cas échéant. L’ordinateur d’état de sauvegarde est avancé de telle sorte que la sauvegarde des fichiers de base de données n’est plus autorisée. Seuls les fichiers correctifs de base de données et les fichiers journaux des transactions sont autorisés à être ouverts pour la sauvegarde au-delà de ce stade.

En cas d’échec, l’état des mémoires tampons de sortie n’est pas défini. L’échec entraîne l’annulation de l’ensemble du processus de sauvegarde pour le instance.

Notes

Il est important de noter que cette API ne retourne pas d’erreur ou d’avertissement si la mémoire tampon de sortie est trop petite pour accepter la liste complète des fichiers qui doivent faire partie de l’ensemble de fichiers de sauvegarde. L’application doit toujours fournir une mémoire tampon pour recevoir la taille réelle de cette liste et utiliser ces informations pour déterminer si la liste a été tronquée.

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.

Unicode

Implémenté en tant que JetGetLogInfoW (Unicode) et JetGetLogInfoA (ANSI).

Voir aussi

JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup

  • Last updated on