DsBackupPrepare-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 Volumeschattenkopie-Dienst (VSS).]

Die DsBackupPrepare-Funktion bereitet das Verzeichnis auf dem angegebenen Server für die Onlinesicherung vor und gibt ein Sicherungskontexthandle zurück, das in nachfolgenden Aufrufen anderer Sicherungsfunktionen verwendet wird.

Syntax

HRESULT DsBackupPrepare(
  _In_  LPCTSTR szBackupServer,
  _In_  ULONG   grbit,
  _In_  ULONG   btBackupType,
  _Out_ PVOID   *ppvExpiryToken,
  _Out_ LPDWORD pcbExpiryTokenSize,
  _Out_ HBC     *phbc
);

Parameter

szBackupServer [ In]

Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des zu sichernden Servers enthält. Die vorangehenden umgekehrten Schrägstriche sind optional. Der Server muss derselbe Computer sein, von dem diese Funktion aufgerufen wird. Der Servername darf keinen Unterstrich _ () enthalten. Ein Beispiel für einen Servernamen ist \ \ "server1".

grbit [ In]

Bestimmt, ob die Protokolldateien gesichert werden. Dieser Wert sollte immer 0 sein, da inkrementelle Sicherungen nicht unterstützt werden.

btBackupType [ In]

Gibt den Sicherungstyp an. Dies kann einer der folgenden Werte sein.

BACKUP _ TYPE _ FULL

Gibt eine vollständige Sicherung an. Das vollständige Verzeichnis (DIT, Protokolldateien und Updatedateien) wird gesichert. Alle Daten werden gesichert, und Transaktionsprotokolldateien werden abgeschnitten. Es werden nur vollständige Sicherungen unterstützt.

_NUR _ SICHERUNGSTYPPROTOKOLLE _

Dieser Wert wird nicht unterstützt. Gibt an, dass nur die Datenbankprotokolle und nicht die Datenbank selbst gesichert werden. Dies wird normalerweise beim Ausführen einer differenziellen oder inkrementellen Sicherung verwendet.

SICHERUNGSTYP _ _ INKREMENTELL

Dieser Wert wird nicht unterstützt. DsBackupPrepare gibt ERROR _ INVALID _ PARAMETER zurück.

ppvExpiryToken [ out]

Zeiger auf einen PVOID-Wert, der einen Zeiger auf ein Ablauftoken empfängt, das dieser Sicherung zugeordnet ist. "pwExpiryTokenSize" empfängt die Größe dieser Daten in Bytes. Der Aufrufer muss den Inhalt dieses Tokens mit der Sicherung speichern, da das Token beim Wiederherstellen von Daten an DsRestorePrepare übergeben werden muss. Nachdem das Token gespeichert wurde und nicht mehr benötigt wird, sollte der Aufrufer den zugeordneten Arbeitsspeicher mithilfe von DsBackupFreefreigeben.

pwExpiryTokenSize [ out]

Zeiger auf einen DWORD-Wert, der die Größe des Tokens in ppvExpiryToken in Bytes empfängt.

phbc [ out]

Zeiger auf einen HBC-Wert, der das Handle für die Sicherung empfängt. Dieses Handle wird verwendet, wenn andere Verzeichnisdienst-Sicherungsfunktionen wie DsBackupOpenFile und DsBackupEndaufgerufen werden.

Rückgabewert

Gibt S _ OK zurück, wenn die Funktion erfolgreich ist, oder andernfalls ein Fehlercode. In der folgenden Liste sind weitere mögliche Fehlercodes aufgeführt.

FEHLERZUGRIFF _ _ VERWEIGERT

Der Aufrufer verfügt nicht über die richtigen 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.

FEHLER: _ UNGÜLTIGER _ PARAMETER

szBackupServer oder phbcBackupContext sind ungültig.

FEHLER _ NICHT _ GENÜGEND _ ARBEITSSPEICHER

Fehler bei der Speicherbelegung.

hrConnectNotConnect

Der Server in szBackupServer wurde nicht gefunden, ist kein Domänencontroller, oder szBackupServer ist nicht ordnungsgemäß formatiert. Dieser Wert wird in ntdsbmsg.h definiert.

hrInvalidParam

ppvExpiryToken und/oder pwExpiryTokenSize sind ungültig. Dieser Wert ist in Ntdsbmsg.h definiert.

_RPC S _ UNGÜLTIGE _ BINDUNG

Die Funktion wird remote aufgerufen, oder der Server in szServerName ist kein Domänencontroller.

Hinweise

Diese Funktion erfordert, dass der Aufrufer über die berechtigung SE _ BACKUP _ NAME verfügt. Die DsSetAuthIdentity-Funktion kann verwendet werden, um den Sicherheitskontext zu ändern, unter dem diese Funktion aufgerufen wird.

Anforderungen

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

Weitere Informationen

DsRestorePrepare

DsBackupFree

DsBackupOpenFile

DsBackupEnd

DsSetAuthIdentity

Sichern eines Active Directory-Servers

Verzeichnissicherungsfunktionen