Partager via


Fonction DsBackupTruncateLogs

[Cette fonction peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. À compter de Windows Vista, utilisez le service VSS (Volume Shadow Copy Service) à la place.]

La fonction DsBackupTruncateLogs tronque les journaux de sauvegarde précédemment lus.

Syntaxe

HRESULT DsBackupTruncateLogs(
  _In_ HBC hbc
);

Paramètres

hbc [in]

Contient le handle de contexte de sauvegarde obtenu avec la fonction DsBackupPrepare .

Valeur retournée

Retourne S_OK si la fonction réussit ou si un code d’erreur Win32 ou RPC est différent. La liste suivante répertorie d’autres codes d’erreur possibles.

ERROR_ACCESS_DENIED

L’appelant ne dispose pas des privilèges d’accès appropriés pour appeler cette fonction. La fonction DsSetAuthIdentity peut être utilisée pour définir les informations d’identification à utiliser pour les fonctions de sauvegarde et de restauration.

ERROR_INVALID_PARAMETER

hbc n’est pas valide.

Notes

Utilisez la fonction DsBackupTruncateLogs lorsqu’une sauvegarde complète ou incrémentielle s’est terminée avec succès.

Attention

Si cette fonction est appelée après une sauvegarde différentielle, toutes les informations de sauvegarde incrémentielle sont perdues.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
Ntdsbcli.h
Bibliothèque
Ntdsbcli.lib
DLL
Ntdsbcli.dll

Voir aussi

DsBackupPrepare

DsBackupGetBackupLogs

DsSetCurrentBackupLog

Sauvegarde d’un serveur Active Directory

Fonctions de sauvegarde d’annuaire