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
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.

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

Weitere Informationen

IVssComponent

IVssComponent::GetAlternateLocationMapping