IVssComponent::GetAlternateLocationMappingCount-Methode (vswriter.h)
Die GetAlternateLocationMappingCount-Methode gibt die Anzahl der alternativen Standortzuordnungen zurück, die von einem Anforderer beim Wiederherstellen von Daten verwendet werden. Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.
Syntax
HRESULT GetAlternateLocationMappingCount(
[out] UINT *pcMappings
);
Parameter
[out] pcMappings
Die Adresse einer vom Aufrufer zugewiesenen Variablen, die die Anzahl der alternativen Standortzuordnungen empfängt.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
Hinweise
Die Anzahl der alternativen Speicherortzuordnungen, die von GetAlternateLocationMappingCount zurückgegeben werden, kann nicht nur auf Dateien in der aktuellen Komponente zurückzuführen sein, sondern auch auf Dateien in ihren nicht auswählbaren Unterkomponenten.
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 GetAlternateLocationMappingCount zurückgegebene Anzahl bezieht sich auf die Anzahl alternativer Speicherortzuordnungen, die beim Wiederherstellen von Dateien verwendet werden.
Die Anzahl wird durch Aufrufe von IVssBackupComponents::AddAlternativeLocationMapping aktualisiert.
Anforderungen
| 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 |