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
Ntdsbcli.h
Bibliothek
Ntdsbcli.lib
DLL
Ntdsbcli.dll
Unicode- und ANSI-Name
DsRestorePrepareW (Unicode) und DsRestorePrepareA (ANSI)

Weitere Informationen

Wiederherstellen eines Active Directory-Servers

Verzeichnissicherungsfunktionen

DsRestoreGetDatabaseLocations

DsRestoreRegister

DsRestoreRegisterComplete

DsRestoreEnd