IVssComponent::GetDirectedTarget-Methode (vswriter.h)

Die GetDirectedTarget-Methode gibt informationen zurück, die von einem Writer zum Zeitpunkt der Sicherung an das Dokument sicherungskomponenten gespeichert wurden, um anzugeben, dass eine Datei bei der Wiederherstellung (die Quelldatei) neu zugeordnet werden soll. Die Datei kann in einem neuen Wiederherstellungsziel und/oder in bereichen ihrer Daten an verschiedenen Speicherorten mit dem Wiederherstellungsziel wiederhergestellt werden.

Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.

Syntax

HRESULT GetDirectedTarget(
  [in]  UINT iDirectedTarget,
  [out] BSTR *pbstrSourcePath,
  [out] BSTR *pbstrSourceFileName,
  [out] BSTR *pbstrSourceRangeList,
  [out] BSTR *pbstrDestinationPath,
  [out] BSTR *pbstrDestinationFilename,
  [out] BSTR *pbstrDestinationRangeList
);

Parameter

[in] iDirectedTarget

Indexnummer des gerichteten Ziels. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtanzahl der gerichteten Ziele ist, die einer bestimmten Komponente zugeordnet sind (und deren Unterkomponenten, wenn sie einen Komponentensatz definiert). Der Wert von n wird von IVssComponent::GetDirectedTargetCount zurückgegeben.

[out] pbstrSourcePath

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine Zeichenfolge mit dem Pfad zu dem Verzeichnis empfängt, das zum Zeitpunkt der Sicherung die wiederherzustellende Datei (die Quelldatei) enthielt. Dieser Pfad sollte mit dem Pfad einer Datei übereinstimmen, die bereits in der Komponente oder in einem ihrer Unterkomponenten enthalten ist (wenn die Komponente einen Komponentensatz definiert).

[out] pbstrSourceFileName

Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine Zeichenfolge mit dem Namen der Datei (zum Zeitpunkt der Sicherung) empfängt, die während einer Wiederherstellung neu zugeordnet werden soll (die Quelldatei). Der Name dieser Datei darf keine Wildcardzeichen enthalten und muss ein Element derselben Datei sein, die als Quellpfad (pbstrSourcePath) festgelegt ist.

[out] pbstrSourceRangeList

Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine Zeichenfolge mit einer durch Trennzeichen getrennten Liste von Dateioffsets und Längen empfängt, die den Unterstützungsbereich der Quelldatei (die Abschnitte der wiederherzustellenden Datei) angeben.

Die Anzahl und Länge der Unterstützungsbereiche der Quelldatei muss mit der Anzahl und Größe der Zieldateiunterstützungsbereiche übereinstimmen.

[out] pbstrDestinationPath

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine Zeichenfolge empfängt, die den Pfad enthält, zu dem Quelldateidaten zum Zeitpunkt der Wiederherstellung neu zugeordnet werden.

[out] pbstrDestinationFilename

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine Zeichenfolge mit dem Namen der Datei empfängt, der die Quelldateidaten zum Zeitpunkt der Wiederherstellung neu zugeordnet werden.

[out] pbstrDestinationRangeList

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine Zeichenfolge empfängt, die eine durch Trennzeichen getrennte Liste von Dateioffsets und Längen enthält, die den Zieldateiunterstützungsbereich angeben (Speicherorte, an denen die Abschnitte der Quelldatei wiederhergestellt werden sollen).

Die Anzahl und Länge der Zieldateiunterstützungsbereiche müssen mit der Anzahl und Größe der Quelldateiunterstützungsbereiche übereinstimmen.

Rückgabewert

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

Wert Bedeutung
S_OK
Der Attributwert wurde erfolgreich zurückgegeben.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
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_OBJECT_NOT_FOUND
Das angegebene Element wurde nicht gefunden.

Hinweise

Wenn der Aufruf von GetDirectedTarget erfolgreich ist, ist der Aufrufer dafür verantwortlich, jede zurückgegebene Zeichenfolge durch Aufrufen der SysFreeString-Funktion freizugeben.

Ein Anforderer verwendet die im Dokument sicherungskomponenten gespeicherten zielgerichteten Informationen nur, wenn das Wiederherstellungsziel VSS_RT_DIRECTED ist.

Die Syntax der Bereichsauflistung (wszSourceRanges und wszDestinationRanges) ist die einer durch Trennzeichen getrennten Liste der Form offset1:length1, offset2:length2, wobei jeder Offset und jede Länge eine 64-Bit-Ganzzahl ist, die einen Byteoffset und eine Länge in Bytes angibt. Der Offset und die Länge können entweder als Hexadezimal- oder Dezimalwerte ausgedrückt werden.

Dateien, deren gerichtete Ziele von GetDirectedTarget zurückgegeben werden, können Member der Dateien der aktuellen Komponente oder einer von ihr definierten Unterkomponente sein.

Der Aufrufer sollte den Arbeitsspeicher der Parameter pbstrSourcePath, pbstrSourceFileName, pbstrSourceRangeList, pbstrDestinationPath, pbstrDestinationFilename und pbstrDestinationRangeList durch Aufrufen von SysFreeString freigeben.

Partielle Dateien können als gerichtete Ziele hinzugefügt werden, wenn die zu sichernden Teildateibereiche mit den gerichteten Zielquellbereichen übereinstimmen (siehe IVssComponent::AddPartialFile). Dadurch können Sie Partielle Dateien neu zuordnen.

Der Anforderer muss überprüfen, ob die gerichtete Zielquelldatei als Teildatei gesichert wurde, um die Wiederherstellung ordnungsgemäß zu implementieren. Wenn dies der Fall ist, verwendet der Anforderer die gerichteten Zielinformationen in Verbindung mit den Teildateiinformationen (IVssComponent::GetPartialFile), um die Neuzuordnung der gesicherten Daten während der Wiederherstellung zu implementieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssComponent

IVssComponent::AddDirectedTarget

IVssComponent::GetDirectedTargetCount