IVssComponent::AddDirectedTarget-Methode (vswriter.h)
Die AddDirectedTarget-Methode ermöglicht es einem Writer, beim Wiederherstellungszeitpunkt anzugeben, dass eine Datei (die Quelldatei) neu zugeordnet werden soll, wenn sie wiederhergestellt werden soll. Die Datei kann an einem neuen Wiederherstellungsspeicherort und/oder an einem neuen Wiederherstellungsbereich ihrer Daten in verschiedenen Offsets innerhalb des Wiederherstellungsspeicherorts wiederhergestellt werden.
Diese Methode kann von einem Writer nur während eines Wiederherstellungsvorgangs aufgerufen werden.
Diese Methode kann nicht aufgerufen werden, wenn ein BackupComplete-Ereignis (CVssWriter::OnBackupComplete) oder BackupShutdown (CVssWriter::OnBackupShutdown) behandelt wird.
Syntax
HRESULT AddDirectedTarget(
[in] LPCWSTR wszSourcePath,
[in] LPCWSTR wszSourceFilename,
[in] LPCWSTR wszSourceRangeList,
[in] LPCWSTR wszDestinationPath,
[in] LPCWSTR wszDestinationFilename,
[in] LPCWSTR wszDestinationRangeList
);
Parameter
[in] wszSourcePath
Mit Null beendete Breitzeichenzeichenfolge, die den Pfad zum Verzeichnis zum Zeitpunkt der Wiederherstellung mit der wiederherzustellenden Datei (quelldatei) enthält. Dieser Pfad sollte mit dem Pfad einer Datei übereinstimmen, die bereits in der Komponente enthalten ist (oder einer ihrer Unterkomponenten, wenn die Komponente einen Komponentensatz definiert).
[in] wszSourceFilename
Mit Null beendete Breitzeichenzeichenfolge, die den Namen der Datei (zum Zeitpunkt der Sicherung) enthält, die zum Zeitpunkt der Wiederherstellung neu zugeordnet wird (die Quelldatei). Der Name der Datei (wszSourceFilename) darf keine Wildcardzeichen (* oder ?) enthalten und muss mit der Dateispezifikation eines Dateisatzes konsistent sein, der den Quellpfad (wszSourcePath) enthält.
[in] wszSourceRangeList
Eine mit NULL beendete Breitzeichenzeichenfolge, die eine durch Trennzeichen getrennte Liste von Dateioffsets und Längen enthält, die den Unterstützungsbereich der Quelldatei (die Abschnitte der Datei, die tatsächlich wiederhergestellt werden sollen) angibt.
Die Anzahl und Länge der Unterstützungsbereiche der Quelldatei muss mit der Anzahl und Größe der Zieldateiunterstützungsbereiche übereinstimmen.
[in] wszDestinationPath
Mit Null beendete Breitzeichenzeichenfolge, die den Pfad enthält, zu dem Quelldateidaten zum Zeitpunkt der Wiederherstellung neu zugeordnet werden.
[in] wszDestinationFilename
Mit Null beendete Breitzeichenzeichenfolge, die den Namen der Datei enthält, der die Quelldateidaten zum Zeitpunkt der Wiederherstellung neu zugeordnet werden. Der Name der Datei (wszDestinationFilename) darf keine Wildcardzeichen (* oder ?) enthalten.
[in] wszDestinationRangeList
Eine mit NULL endende Breitzeichenzeichenfolge, 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 |
|---|---|
|
Das Element wurde erfolgreich festgelegt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Diese Methode wurde nicht von einem Writer aufgerufen, oder, wenn sie von einem Writer aufgerufen wird, wurde sie entweder nicht während eines Wiederherstellungsvorgangs oder während der Behandlung eines BackupComplete- oder BackupShutdown-Ereignisses aufgerufen. |
Hinweise
Nur ein Writer kann AddDirectedTarget aufrufen, und zwar nur bei Wiederherstellungsvorgängen.
Ein Anforderer verwendet die im Dokument sicherungskomponenten gespeicherten zielgerichteten Informationen nur, wenn das Wiederherstellungsziel VSS_RT_DIRECTED ist.
Die AddDirectedTarget-Methode kann auf jede Datei angewendet werden, die in der aktuellen Komponente oder, wenn die Komponente einen Komponentensatz definiert, in einem ihrer nicht auswählbaren Unterkomponenten verwaltet wird.
Quell- und Zieldateispezifikationen verweisen möglicherweise auf dieselbe Datei. Dies würde es ermöglichen, eine Datei zum Zeitpunkt der Wiederherstellung in sich selbst neu zu erstellen.
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.
Die Anzahl der Einträge und ihre Größe müssen im Quell- und Zielbereichsargument übereinstimmen.
AddDirectedTarget kann als Quelldatei jede Datei verwenden, die bereits von der Komponente oder einer ihrer Unterkomponenten verwaltet wird, wenn die Komponente einen Komponentensatz definiert.
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 Teildateien zum Zeitpunkt der Wiederherstellung neu zuordnen.
In diesem Fall ruft der Anforderer die zielbezogenen Informationen ab, indem er die IVssComponent::GetDirectedTarget-Methode aufruft und diese verwendet, 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 |