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. Ab Windows Vista verwenden Sie stattdessen Volumeschattenkopie-Dienst (VSS).]
Die DsRestorePrepare-Funktion stellt eine Verbindung mit dem angegebenen Verzeichnisserver und bereitet sie 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 auf NULL beendete Zeichenfolge, die den Namen des wiederherzustellenden Servers enthält. Vorangehende schräge 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 0 (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 erfolgt, wenn NTDS online ist.
pvExpiryToken [ In]
Zeiger auf das Ablauftoken, das der wiederherzustellenden Sicherung zugeordnet ist. Dieses Token wurde von der DsBackupPrepare-Funktion beim Sichern des Verzeichnisses erhalten.
Wenn dieser Parameter NULL ist, kann das in phbc zurückgegebene Handle nur zum Abrufen der Wiederherstellungsverzeichnisse mit der DsRestoreGetDatabaseLocations-Funktion verwendet werden. Das Handle kann nicht für andere Wiederherstellungsfunktionen verwendet werden.
cbExpiryTokenSize [ In]
Enthält die Größe des Ablauftokens in pvExpiryToken in Bytes.
phbc [ out]
Zeiger auf einen HBC-Wert, der das Handle für die Wiederherstellung empfängt. Dieses Handle wird beim Aufrufen anderer Wiederherstellungsfunktionen des Verzeichnisdiensts verwendet, z. B. DsBackupOpenFile und DsRestoreEnd.
Rückgabewert
Wenn erfolgreich, gibt einen HRESULT-Standardcode zurück. Andernfalls wird ein Fehlercode zurückgegeben.
Hinweise
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. Sie darf nicht für die DsRestoreRegister-Funktion verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsRestorePrepareW (Unicode) und DsRestorePrepareA (ANSI) |