JetGetTruncateLogInfoInstance fonction)

S’applique à : Windows | Windows Serveurs

JetGetTruncateLogInfoInstance fonction)

La fonction JetGetTruncateLogInfoInstance est utilisée lors d’une sauvegarde initiée par JetBeginExternalBackup pour interroger une instance afin d’obtenir les noms des fichiers journaux des transactions qui peuvent être supprimés en toute sécurité une fois la sauvegarde terminée.

**Windows xp :**JetGetTruncateLogInfoInstance est introduit dans Windows xp.

    JET_ERR JET_API JetGetTruncateLogInfoInstance(
      __in          JET_INSTANCE instance,
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Paramètres

instancié

Instance à utiliser pour cet appel.

szz

Mémoire tampon de sortie qui reçoit la liste des chaînes terminées par le caractère null qui décrivent l’ensemble des fichiers journaux des transactions qui peuvent être supprimés en toute sécurité une fois la sauvegarde terminée.

La liste des chaînes retournées dans cette mémoire tampon est au même format qu’une chaîne multiple utilisée par le registre. Chaque chaîne terminée par le caractère NULL est retournée dans l’ordre et suivie d’une marque de fin null finale.

cbMax

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

pcbActual

Pointeur vers la mémoire tampon de sortie qui reçoit la quantité réelle de données de chaîne.

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

L’un des paramètres fournis contenait une valeur inattendue ou la combinaison de plusieurs valeurs de paramètre a entraîné un résultat inattendu.

Windows XP et versions ultérieures : Cela peut se produire pour JetGetTruncateLogInfoInstance lorsque le handle d’instance spécifié n’est pas valide.

JET_errNotInitialized

Impossible d’effectuer l’opération, car l’instance associée à la session n’a pas encore été initialisée.

JET_errClientRequestToStopJetService

Impossible d’effectuer l’opération, car toute activité sur l’instance associée à la session a été interrompue 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 a été introduite dans Windows XP.

JET_errBackupAbortByServer

L’opération a échoué, car la sauvegarde externe actuelle a été abandonnée par un appel à JetStopBackup.

Windows XP : cette valeur de retour a été introduite dans Windows XP.

JET_errInvalidBackupSequence

L’opération de sauvegarde a échoué, car elle était appelée hors séquence.

JET_errNoBackup

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

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.

JetGetTruncateLogInfoInstance

Des descripteurs de fichiers en attente ont été créés à l’aide de JetOpenFile pour l’instance.

Si cette fonction réussit, les informations demandées sur l’ensemble des fichiers journaux des transactions qui peuvent être supprimés en toute sécurité une fois la sauvegarde terminée, sont placées dans les tampons de sortie où elles sont fournies. L’ordinateur d’état de sauvegarde est avancé, de sorte que la sauvegarde des fichiers de base de données n’est plus autorisée. Seuls les fichiers de correctifs de base de données et les fichiers journaux de transactions peuvent être ouverts pour la sauvegarde au-delà de ce point.

Si cette fonction échoue, 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 de l’instance.

Remarques

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 du jeu 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.

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.

Unicode

Implémenté en tant que JetGetTruncateLogInfoInstanceW (Unicode) et JetGetTruncateLogInfoInstanceA (ANSI).

Voir aussi

JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetCloseDatabase
JetCloseTable
JetEndSession
JetOpenFile
JetResetSessionContext
JetRollback
JetStopBackup
JetStopService
JetTerm
JetTerm2