DsRestoreRegister-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 den Volume Shadow Copy Service (VSS).
Die DsRestoreRegister-Funktion registriert einen Wiederherstellungsvorgang. Diese Funktion verzahnt alle nachfolgenden Wiederherstellungsvorgänge und verhindert, dass das Wiederherstellungsziel gestartet wird, bis die DsRestoreRegisterComplete-Funktion aufgerufen wird.
Syntax
HRESULT DsRestoreRegister(
_In_ HBC hbc,
_In_ LPCTSTR szCheckPointFilePath,
_In_ LPCTSTR szLogPath,
_In_ EDB_RSTMAP rgrstmap[],
_In_ LONG crstmap,
_In_ LPCTSTR szBackupLogPath,
_In_ ULONG genLow,
_In_ ULONG genHigh
);
Parameter
-
hbc [in]
-
Enthält das Mit der DsRestorePrepare-Funktion abgerufene Wiederherstellungskontexthandle.
-
szCheckPointFilePath [in]
-
Zeiger auf eine NULL-Zeichenfolge, die den Pfad zur Prüfpunktdatei enthält. Dieser Pfad wird von der DsRestoreGetDatabaseLocations-Funktion bereitgestellt und weist den BFT-WertBFT_CHECKPOINT_DIR auf. In der Regel ist dies mit dem Systemdatenbankpfad identisch. Dieser Pfad ist für eine ordnungsgemäße Sicherungswiederherstellung erforderlich. Dieser Parameter darf nicht NULL sein. Das Übergeben von NULL in diesem Parameter führt während des Wiederherstellungsvorgangs zu einem Fehler.
-
szLogPath [in]
-
Zeiger auf eine NULL-Zeichenfolge, die den Pfad enthält, in dem die Protokolldateien wiederhergestellt werden. Dieser Pfad wird von der DsRestoreGetDatabaseLocations-Funktion bereitgestellt und weist den BFT-WertBFT_LOG_DIR auf. Wenn der Pfad auf ein leeres Verzeichnis verweist, werden dort neue Protokolldateien erstellt. Dieser Parameter darf nicht NULL sein.
-
rgrstmap [in]
-
Ein Array von EDB_RSTMAP Strukturen, das die alten und neuen Pfade für jede Datenbank enthält. Für jede Datenbank gibt es eine Struktur. Für das Verzeichnis gibt es eine Struktur für die Systemdatenbank und eine andere Struktur für die Verzeichnisdatenbank. Die Reihenfolge der Elemente im Array spielt keine Rolle. Der Crstmap-Parameter enthält die Anzahl der Elemente im Array.
-
crstmap [in]
-
Enthält die Anzahl der Elemente im rgrstmap-Array .
-
szBackupLogPath [in]
-
Zeiger auf eine NULL-Zeichenfolge, die den Pfad enthält, in dem sich derzeit die gesicherten Protokolldateien befinden. Dieser Parameter darf nicht NULL sein.
-
genLow [in]
-
Enthält die niedrigste Protokollnummer, die in dieser Wiederherstellungssitzung wiederhergestellt werden soll. Dies ist eine hexadezimale Zahl im Bereich von 0x00000 bis 0xFFFFF.
-
genHigh [in]
-
Enthält die höchste Protokollnummer, die in dieser Wiederherstellungssitzung wiederhergestellt werden soll. Dies ist eine hexadezimale Zahl im Bereich von 0x00000 bis 0xFFFFF.
Rückgabewert
Gibt S_OK zurück, wenn die Funktion erfolgreich ist oder andernfalls ein Win32- oder RPC-Fehlercode. Die folgende Liste listet mögliche Fehlercodes auf.
-
ERROR_ACCESS_DENIED
-
Der Aufrufer verfügt nicht über die erforderlichen 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
-
Mindestens ein Parameter ist ungültig.
-
hrMissingExpiryToken
-
Das für DsRestorePrepare bereitgestellte Ablauftoken war ungültig. Dieser Wert wird in Ntdsbmsg.h definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsRestoreRegisterW (Unicode) und DsRestoreRegisterA (ANSI) |