IVssComponent::GetNewTarget-Methode (vswriter.h)
Die GetNewTarget-Methode gibt die neuen Dateiwiederherstellungsspeicherorte für die ausgewählte Komponente oder den ausgewählten Komponentensatz zurück. (Informationen zur Auswahl von Komponenten finden Sie unter Arbeiten mit Auswählbarkeit und logischen Pfaden .)
Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.
Syntax
HRESULT GetNewTarget(
[in] UINT iNewTarget,
[out] IVssWMFiledesc **ppFiledesc
);
Parameter
[in] iNewTarget
Indexnummer des neuen Ziels. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtanzahl neuer Ziele ist, die einer bestimmten Komponente zugeordnet sind. Der Wert von n wird von IVssComponent::GetNewTargetCount zurückgegeben.
[out] ppFiledesc
Doppelt indirekter Zeiger auf ein IVssWMFiledesc-Objekt , das die neuen Informationen zum Zielwiederherstellungsort enthält.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über 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
Neue Ziele, die von GetNewTarget zurückgegeben werden, können nicht nur Dateien in der aktuellen Komponente sein, sondern auch Dateien in ihren nicht auswählbaren Unterkomponenten.
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 (einschließlich Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |