DsRestoreGetDatabaseLocations-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 DsRestoreGetDatabaseLocations-Funktion ruft die Speicherorte ab, an denen Sicherungsdateien während eines Wiederherstellungsvorgangs kopiert werden sollen.
Syntax
HRESULT DsRestoreGetDatabaseLocations(
_In_ HBC hbc,
_Out_ LPWSTR *pszDatabaseLocationList,
_Out_ LPDWORD pcbSize
);
Parameter
-
hbc [in]
-
Enthält das Mit der DsRestorePrepare-Funktion abgerufene Wiederherstellungskontexthandle.
-
pszDatabaseLocationList [out]
-
Zeiger auf einen Zeichenfolgenzeiger, der die Liste der Datenbankspeicherorte als UNC-Pfade empfängt. Diese Liste empfängt eine doppelte NULL-beendete Liste mit einzelnen null-beendeten Zeichenfolgen.
Dieser Puffer wird von der DsRestoreGetDatabaseLocations-Funktion zugewiesen und muss freigegeben werden, wenn er nicht mehr benötigt wird, indem die DsBackupFree-Funktion aufgerufen wird.
Das erste Zeichen jedes Dateinamens enthält eine der BFT-Konstanten , die den Namenstyp identifiziert. Die DsRestoreGetDatabaseLocations-Funktion stellt nur die folgenden Namenstypen bereit.
-
BFT_NTDS_DATABASE
-
Die NTDS-Datenbankdatei sollte in diese Datei kopiert werden. Dies ist die Datei, die beim Ausfü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 ausgeführt wurde.
-
BFT_CHECKPOINT_DIR
-
Alle Patchdateien werden in dieses Verzeichnis kopiert. Die Patchdateien wurden als BFT_PATCH_FILE identifiziert, als die Sicherung ausgeführt wurde.
pcbSize [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 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
-
hbc, pszDatabaseLocationList oder pcbSize sind ungültig.
-
ERROR_NOT_ENOUGH_MEMORY
-
Ein Fehler bei der Speicherzuordnung ist aufgetreten.
Bemerkungen
Die DsRestoreGetDatabaseLocations-Funktion kann verwendet werden, um die Wiederherstellungsverzeichnisse ohne Zugriff auf die gesicherten Daten abzurufen. Rufen Sie hierzu DsRestorePrepare mit NULL für den parameter pvExpiryToken auf. Dies bewirkt , dass DsRestorePrepare ein eingeschränktes Kontexthandle zurückgibt, das nur mit der DsRestoreGetDatabaseLocations-Funktion verwendet werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsRestoreGetDatabaseLocationsW (Unicode) und DsRestoreGetDatabaseLocationsA (ANSI) |