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
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