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

Siehe auch

DsRestorePrepare

DsBackupFree

Verzeichnissicherungsfunktionen

Wiederherstellen von Active Directory