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