IVssBackupComponents::SetRangesFilePath-Methode (vsbackup.h)

Die SetRangesFilePath-Methode wird verwendet, wenn für einen partiellen Dateivorgang eine Bereichsdatei erforderlich ist und diese Datei an einem anderen Speicherort als dem ursprünglichen wiederhergestellt wurde.

Syntax

HRESULT SetRangesFilePath(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] UINT               iPartialFile,
  [in] LPCWSTR            wszRangesFile
);

Parameter

[in] writerId

GuiD (Globally Unique Identifier) der Writer-Klasse, die die Dateien enthält, die am Partiellen Dateivorgang beteiligt sind.

[in] ct

Gibt den Typ der Komponente an. Mögliche Rückgabewerte finden Sie unter VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Mit Null beendete Breitzeichenzeichenfolge, die den logischen Pfad der Komponente enthält, die die Dateien enthält, die am Teildateivorgang teilnehmen.

Weitere Informationen finden Sie unter Logische Pfade von Komponenten.

Der Wert der Zeichenfolge, die den hier verwendeten logischen Pfad enthält, sollte dem Wert entsprechen, der verwendet wurde, als die Komponente mithilfe von IVssBackupComponents::AddComponent dem Sicherungssatz hinzugefügt wurde.

Der logische Pfad kann NULL sein.

Es gibt keine Einschränkungen für die Zeichen, die in einem logischen Pfad ohne NULL angezeigt werden können.

[in] wszComponentName

Mit Null beendete Breitzeichenzeichenfolge, die den Namen der Komponente enthält, die die Dateien enthält, die am Partiellen Dateivorgang teilnehmen.

Die Zeichenfolge darf nicht NULL sein und sollte denselben Komponentennamen wie beim Hinzufügen der Komponente zum Sicherungssatz mithilfe von IVssBackupComponents::AddComponent enthalten.

[in] iPartialFile

Indexnummer der Teildatei. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtanzahl der Teildateien ist, die einer bestimmten Komponente zugeordnet sind. Der Wert von n wird von IVssComponent::GetPartialFileCount zurückgegeben.

[in] wszRangesFile

Mit Null beendete Breitzeichenzeichenfolge, die den vollqualifizierten Pfad einer Bereichsdatei enthält.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
Das neue Wiederherstellungsziel wurde erfolgreich hinzugefügt.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE
Das Sicherungskomponentenobjekt wird nicht initialisiert, oder diese Methode wurde nicht während eines Wiederherstellungsvorgangs aufgerufen.
VSS_E_OBJECT_NOT_FOUND
Die Komponente ist nicht vorhanden, oder die Pfad- und Dateispezifikation stimmen nicht mit einer Komponenten- und Dateispezifikation in der Komponente überein.
VSS_E_INVALID_XML_DOCUMENT
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_UNEXPECTED
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

Der Aufruf von SetRangesFilePath ist nicht erforderlich, wenn Bereichsdateien wiederhergestellt werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssComponent::AddPartialFile

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount