IVssComponent::GetAlternateLocationMapping-Methode (vswriter.h)

  • Artikel

GetAlternateLocationMapping wird verwendet, um den alternativen Speicherort eines Dateisatzes für die Dateiwiederherstellung zurückzugeben. Diese Methode kann entweder von einem Writer oder einem Anforderer aufgerufen werden.

Syntax

HRESULT GetAlternateLocationMapping(
  [in]  UINT           iMapping,
  [out] IVssWMFiledesc **ppFiledesc
);

Parameter

[in] iMapping

Index einer bestimmten Zuordnung. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtzahl der alternativen Standortzuordnungen entspricht, die der aktuellen Komponente zugeordnet sind. Der Wert von n wird von IVssComponent::GetAlternateLocationMappingCount zurückgegeben.

[out] ppFiledesc

Doppelt indirekter Zeiger auf ein IVssWMFiledesc-Objekt , das die Zuordnungsinformationen enthält.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

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

Alternative Speicherortzuordnungen, die von GetAlternateLocationMapping zurückgegeben werden, können nicht nur aus Dateien in der aktuellen Komponente stammen, sondern auch aus Dateien in ihren nicht auswählbaren Unterkomponenten.

Der von IVssComponent::GetAlternateLocationMapping zurückgegebene Wert sollte auch nicht mit dem von IVssExamineWriterMetadata::GetAlternateLocationMapping zurückgegebenen Wert verwechselt werden:

  • IVssExamineWriterMetadata::GetAlternateLocationMapping ist die alternative Speicherortzuordnung, an der eine Datei bei Bedarf wiederhergestellt werden kann.
  • IVssComponent::GetAlternateLocationMapping ist der alternative Speicherort, an dem eine Datei tatsächlich wiederhergestellt wurde.
Eine Datei sollte immer in ihrer alternativen Speicherortzuordnung wiederhergestellt werden, wenn eine der folgenden Punkte zutrifft:
  • Die Wiederherstellungsmethode (zum Zeitpunkt der Sicherung festgelegt) ist VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
  • Das Wiederherstellungsziel wurde (zum Zeitpunkt der Wiederherstellung) auf VSS_RT_ALTERNATE festgelegt.
In beiden Fällen stellt die Definition einer alternativen Standortzuordnung einen Writerfehler dar.

Eine Datei kann in einer alternativen Speicherortzuordnung wiederhergestellt werden, wenn eine der folgenden Punkte zutrifft:

  • Die Wiederherstellungsmethode ist VSS_RME_RESTORE_IF_NOT_THERE, und eine Version der Datei ist bereits auf dem Datenträger vorhanden.
  • Die Wiederherstellungsmethode ist VSS_RME_RESTORE_IF_CAN_REPLACE, und eine Version der Datei ist auf dem Datenträger vorhanden und kann nicht ersetzt werden.
Eine alternative Speicherortzuordnung wird nur während eines Wiederherstellungsvorgangs verwendet und sollte nicht mit einem alternativen Pfad verwechselt werden, der nur während eines Sicherungsvorgangs verwendet wird.

Die von GetAlternateLocationMapping zurückgegebene Zuordnung bezieht sich auf die alternativen Speicherortzuordnungen, die beim Wiederherstellen von Dateien verwendet werden.

Alternative Standortzuordnungen werden einem IVssComponent-Objekt von IVssBackupComponents::AddAlternativeLocationMapping hinzugefügt.

Der Aufrufer muss IUnknown::Release aufrufen, um die Systemressourcen des ppMapping-Parameters freizugeben, wenn dies mit dem IVssWMFiledesc-Objekt erfolgt, auf das er verweist.

Weitere Informationen zu Sicherungs- und Wiederherstellungsdateispeicherorten unter VSS finden Sie unter Nicht standardmäßige Sicherungs- und Wiederherstellungsspeicherorte.

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

Weitere Informationen

IVssBackupComponents::AddAlternativeLocationMapping

IVssComponent

IVssExamineWriterMetadata::GetAlternateLocationMapping