DsBackupTruncateLogs-Funktion

[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie ab Windows Vista stattdessen den Volume Shadow Copy Service (VSS).

Die DsBackupTruncateLogs-Funktion schneidet die zuvor gelesenen Sicherungsprotokolle ab.

Syntax

HRESULT DsBackupTruncateLogs(
  _In_ HBC hbc
);

Parameter

hbc [in]

Enthält das Sicherungskontexthandle, das mit der DsBackupPrepare-Funktion abgerufen wurde.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist oder andernfalls ein Win32- oder RPC-Fehlercode. In der folgenden Liste sind weitere mögliche Fehlercodes aufgeführt.

ERROR_ACCESS_DENIED

Der Aufrufer verfügt nicht über die erforderlichen Zugriffsberechtigungen zum Aufrufen dieser Funktion. Die DsSetAuthIdentity-Funktion kann verwendet werden, um die Anmeldeinformationen festzulegen, die für die Sicherungs- und Wiederherstellungsfunktionen verwendet werden sollen.

ERROR_INVALID_PARAMETER

hbc ist ungültig.

Bemerkungen

Verwenden Sie die DsBackupTruncateLogs-Funktion , wenn eine vollständige oder inkrementelle Sicherung erfolgreich abgeschlossen wurde.

Achtung

Wenn diese Funktion nach einer differenziellen Sicherung aufgerufen wird, gehen alle inkrementellen Sicherungsinformationen verloren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Header	Ntdsbcli.h
Bibliothek	Ntdsbcli.lib
DLL	Ntdsbcli.dll

Weitere Informationen

DsBackupPrepare

DsBackupGetBackupLogs

DsSetCurrentBackupLog

Sichern eines Active Directory-Servers

Verzeichnissicherungsfunktionen