DsRestorePrepare-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 DsRestorePrepare-Funktion stellt eine Verbindung mit dem angegebenen Verzeichnisserver her und bereitet ihn für den Wiederherstellungsvorgang vor.
Syntax
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
Parameter
-
szServerName [in]
-
Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des wiederherzustellenden Servers enthält. 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".
-
rtFlag [in]
-
Gibt den Typ der durchzuführenden Wiederherstellung an. Dies kann null oder einer der folgenden Werte sein.
-
RESTORE_TYPE_CATCHUP
-
Standard. Die wiederhergestellte Version wird über die Standardabstimmungslogik abgestimmt, sodass die wiederhergestellte DIT mit anderen Unternehmensservercomputern synchronisiert werden kann.
-
RESTORE_TYPE_AUTHORATATIVE
-
Nicht unterstützt.
-
RESTORE_TYPE_ONLINE
-
Nicht unterstützt. Die Wiederherstellung wird ausgeführt, wenn NTDS online ist.
pvExpiryToken [in]
Zeiger auf das Ablauftoken, das der wiederhergestellten Sicherung zugeordnet ist. Dieses Token wurde von der DsBackupPrepare-Funktion abgerufen, als das Verzeichnis gesichert wurde.
Wenn dieser Parameter NULL ist, kann das in phbc zurückgegebene Handle nur verwendet werden, um die Wiederherstellungsverzeichnisse mit der DsRestoreGetDatabaseLocations-Funktion abzurufen. Das Handle kann nicht für andere Wiederherstellungsfunktionen verwendet werden.
cbExpiryTokenSize [in]
Enthält die Größe des Ablauftokens in Bytes in pvExpiryToken.
phbc [out]
Zeiger auf einen HBC-Wert , der das Handle für die Wiederherstellung empfängt. Dieses Handle wird verwendet, wenn andere Wiederherstellungsfunktionen des Verzeichnisdiensts aufgerufen werden, z. B. DsBackupOpenFile und DsRestoreEnd.
Rückgabewert
Gibt bei erfolgreicher Ausführung einen HRESULT-Standardcode zurück. Andernfalls wird ein Fehlercode zurückgegeben.
Bemerkungen
Die DsRestorePrepare-Funktion erfordert, dass der Aufrufer Mitglied der Gruppe Administratoren auf dem Server ist.
DsRestorePrepare kann mit oder ohne bereitgestelltes Token verwendet werden. Wenn das Token bereitgestellt wird, wird es auf Ablauf überprüft, und alle Vorgänge sind für den zurückgegebenen Kontext zulässig. Wenn das Token nicht bereitgestellt wird, ist der zurückgegebene Kontext eingeschränkt und kann nur für die DsRestoreGetDatabaseLocations-Funktion verwendet werden. Es darf nicht für die DsRestoreRegister-Funktion verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsRestorePrepareW (Unicode) und DsRestorePrepareA (ANSI) |