DsBackupPrepare-Funktion
[Diese Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie ab Windows Vista stattdessen den Volume Shadow Copy Service (VSS). ]
Die DsBackupPrepare-Funktion bereitet das Verzeichnis auf dem angegebenen Server für die Onlinesicherung vor und gibt ein Sicherungskontexthandle zurück, das bei 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 NULL-endende Zeichenfolge, die den Namen des zu sichernden Servers enthält. Vorangehende umgekehrte 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.
-
BACKUP_TYPE_LOGS_ONLY
-
Dieser Wert wird nicht unterstützt. Gibt an, dass nur die Datenbankprotokolle und nicht die Datenbank selbst gesichert werden. Dies wird normalerweise verwendet, wenn eine differenzielle oder inkrementelle Sicherung ausgeführt wird.
-
BACKUP_TYPE_INCREMENTAL
-
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. pcbExpiryTokenSize empfängt die Größe dieser Daten in Bytes. Der Aufrufer muss den Inhalt dieses Tokens mit der Sicherung speichern, da das Token beim Versuch, Daten wiederherzustellen, an DsRestorePrepare übergeben werden muss. Nachdem das Token gespeichert wurde und nicht mehr benötigt wird, sollte der Aufrufer den zugeordneten Arbeitsspeicher mithilfe von DsBackupFree freigeben.
pcbExpiryTokenSize [out]
Zeiger auf einen DWORD-Wert , der die Größe des Tokens in Bytes in ppvExpiryToken empfängt.
phbc [out]
Zeiger auf einen HBC-Wert , der das Handle für die Sicherung empfängt. Dieses Handle wird verwendet, wenn andere Verzeichnisdienstsicherungsfunktionen wie DsBackupOpenFile und DsBackupEnd aufgerufen werden.
Rückgabewert
Gibt S_OK zurück, wenn die Funktion erfolgreich ist oder andernfalls ein Fehlercode vorliegt. In der folgenden Liste sind weitere mögliche Fehlercodes aufgeführt.
-
ERROR_ACCESS_DENIED
-
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.
-
ERROR_INVALID_PARAMETER
-
szBackupServer oder phbcBackupContext sind ungültig.
-
ERROR_NOT_ENOUGH_MEMORY
-
Ein Speicherbelegungsfehler ist aufgetreten.
-
hrCouldNotConnect
-
Der Server in szBackupServer wurde nicht gefunden, ist kein Domänencontroller, oder szBackupServer ist nicht ordnungsgemäß formatiert. Dieser Wert ist in ntdsbmsg.h definiert.
-
hrInvalidParam
-
ppvExpiryToken und/oder pcbExpiryTokenSize sind ungültig. Dieser Wert ist in Ntdsbmsg.h definiert.
-
RPC_S_INVALID_BINDING
-
Die Funktion wird remote aufgerufen, oder der Server in szServerName ist kein Domänencontroller.
Bemerkungen
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) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsBackupPrepareW (Unicode) und DsBackupPrepareA (ANSI) |