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