IVssExamineWriterMetadata::GetAlternateLocationMapping-Methode (vsbackup.h)
Die GetAlternateLocationMapping-Methode ruft eine bestimmte alternative Speicherortzuordnung eines Dateisatzes ab.
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 ist, die einem bestimmten Writer zugeordnet sind. Der Wert von n wird von IVssExamineWriterMetadata::GetRestoreMethod zurückgegeben.
[out] ppFiledesc
Doppelt indirekter Zeiger auf ein IVssWMFiledesc-Objekt , das die Informationen zur alternativen Standortzuordnung enthält.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Es wurde ein Zeiger auf eine IVssWMFiledesc-Schnittstelle 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. |
|
Die angegebene alternative Standortzuordnung ist nicht vorhanden. |
|
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
Hinweise
Der von IVssExamineWriterMetadata::GetAlternateLocationMapping zurückgegebene Wert sollte nicht mit dem von IVssComponent::GetAlternateLocationMapping zurückgegebenen Wert verwechselt werden.
IVssComponent::GetAlternateLocationMapping ist der alternative Speicherort, an dem eine Datei wiederhergestellt wurde.
IVssExamineWriterMetadata::GetAlternateLocationMapping ist die alternative Speicherortzuordnung, an der eine Datei bei Bedarf wiederhergestellt werden kann.
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.
Eine Datei kann in einer alternativen Speicherortzuordnung wiederhergestellt werden, wenn einer 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.
Der Aufrufer ist für den Aufruf von IUnknown::Release verantwortlich, um die Ressourcen des zurückgegebenen IVssWMFiledesc-Objekts freizugeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::AddAlternativeLocationMapping
IVssComponent::GetAlternateLocationMapping