IVssComponent::GetAlternateLocationMapping-Methode (vswriter.h)
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 |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend 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
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.
- 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.
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.
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 |