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 |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsBackupPrepareW (Unicode) und DsBackupPrepareA (ANSI) |