DsRestoreGetDatabaseLocations-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 Funktion DsRestoreGetDatabaseLocations erhält die Speicherorte, an denen Sicherungsdateien während eines Wiederherstellungsvorgang kopiert werden sollen.
Syntax
HRESULT DsRestoreGetDatabaseLocations(
_In_ HBC hbc,
_Out_ LPWSTR *pszDatabaseLocationList,
_Out_ LPDWORD pcbSize
);
Parameter
-
hbc [ In]
-
Enthält das Wiederherstellungskontexthand handle, das mit der DsRestorePrepare-Funktion ermittelt wurde.
-
pszDatabaseLocationList [ out]
-
Zeiger auf einen Zeichenfolgenzeiger, der die Liste der Datenbankstandorte als UNC-Pfade empfängt. Diese Liste empfängt eine doppelte Null-Terminierungsliste mit einzelnen Zeichenfolgen, die mit NULL beendet werden.
Dieser Puffer wird von der DsRestoreGetDatabaseLocations-Funktion zugeordnet und muss durch Aufrufen der DsBackupFree-Funktion wieder frei werden, wenn er nicht mehr benötigt wird.
Das erste Zeichen jedes Dateinamens enthält eine der BFT-Konstanten, die den Namenstyp identifiziert. Die DsRestoreGetDatabaseLocations-Funktion stellt nur die folgenden Namenstypen zur Verfügung.
-
BFT _ _ NTDS-DATENBANK
-
Die NTDS-Datenbankdatei sollte in diese Datei kopiert werden. Dies ist die Datei, die beim Durchführen der Sicherung als BFT _ NTDS _ DATABASE identifiziert wurde.
-
BFT _ LOG _ DIR
-
Alle Protokolldateien werden in dieses Verzeichnis kopiert. Die Protokolldateien wurden als BFT _ LOG identifiziert, als die Sicherung durchgeführt wurde.
-
BFT _ CHECKPOINT _ DIR
-
Alle Patchdateien werden in dieses Verzeichnis kopiert. Die Patchdateien wurden als BFT _ PATCH FILE _ identifiziert, als die Sicherung durchgeführt wurde.
besize [ out]
Zeiger auf den DWORD-Wert, der die Größe des Puffers pszDatabaseLocationList in Bytes empfängt.
Rückgabewert
Gibt S _ OK zurück, wenn die Funktion erfolgreich ist, andernfalls ein Win32- oder RPC-Fehlercode. In der folgenden Liste sind mögliche Fehlercodes aufgeführt.
-
FEHLER _ BEIM _ ZUGRIFF VERWEIGERT
-
Der Aufrufer verfügt nicht über die richtigen Zugriffsberechtigungen zum Aufrufen dieser Funktion. Mit der DsSetAuthIdentity-Funktion können die Anmeldeinformationen festgelegt werden, die für die Sicherungs- und Wiederherstellungsfunktionen verwendet werden sollen.
-
FEHLER _ UNGÜLTIGER _ PARAMETER
-
hbc, pszDatabaseLocationList oderize sind ungültig.
-
FEHLER: _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
-
Es ist ein Speicherbelegungsfehler aufgetreten.
Hinweise
Die Funktion DsRestoreGetDatabaseLocations kann verwendet werden, um die Wiederherstellungsverzeichnisse ohne Zugriff auf die sichern Daten zu erhalten. Rufen Sie hierzu DsRestorePrepare mit NULL für den parameter pvExpiryToken auf. Dadurch gibt DsRestorePrepare ein eingeschränktes Kontexthand handle zurück, das nur mit der DsRestoreGetDatabaseLocations-Funktion verwendet werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsRestoreGetDatabaseLocationsW (Unicode) und DsRestoreGetDatabaseLocationsA (ANSI) |