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 |
|
| Bibliothek |
|
| DLL |
|