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
S_OK
Der Attributwert wurde erfolgreich zurückgegeben.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über 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

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

Weitere Informationen

IVssComponent

IVssComponent::GetNewTargetCount