DsSetCurrentBackupLog-Funktion

Artikel
06/13/2023

[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 DsSetCurrentBackupLog-Funktion legt die aktuelle Sicherungsprotokollnummer nach einer erfolgreichen Wiederherstellung fest. Da Active Directory Domain Services nur die Zirkelprotokollierung unterstützen, wird diese Funktion normalerweise nicht verwendet.

Syntax

HRESULT DsSetCurrentBackupLog(
  _In_ LPCWSTR szServerName,
  _In_ DWORD   dwCurrentLog
);

Parameter

szServerName [in]: Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen des Servers enthält, für den die Sicherungsprotokollnummer festgelegt werden soll. Vorangehende umgekehrte Schrägstriche sind optional. Der Server muss derselbe Computer sein, von dem diese Funktion aufgerufen wird. Der Servername darf keine Unterstriche (_) enthalten. Ein Beispiel für einen Servernamen ist "\\server1".
dwCurrentLog [in]: Enthält die festzulegende Nummer des Sicherungsprotokolls.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist oder andernfalls ein Win32- oder RPC-Fehlercode. Die folgende Liste listet mögliche Fehlercodes auf.

ERROR_INVALID_PARAMETER: Mindestens ein Parameter ist ungültig.
ERROR_NOT_ENOUGH_MEMORY: Ein Fehler bei der Speicherzuordnung ist aufgetreten.

Bemerkungen

Normalerweise ist es nicht erforderlich, die DsSetCurrentBackupLog-Funktion aufzurufen. Die Sicherungsfunktionen ermitteln und legen die zuletzt gesicherte Protokollnummer automatisch fest. Verwenden Sie DsSetCurrentBackupLog , um zu verhindern, dass eine weitere inkrementelle Sicherung erfolgreich ist, bis eine vollständige Sicherung ausgeführt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Header	Ntdsbcli.h
Bibliothek	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Unicode- und ANSI-Name	DsSetCurrentBackupLogW (Unicode) und DsSetCurrentBackupLogA (ANSI)

Siehe auch

Sichern und Wiederherstellen eines Active Directory-Servers
Verzeichnissicherungsfunktionen

Freigeben über