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 |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
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 |