IVssWMFiledesc::GetAlternateLocation-Methode (vswriter.h)

Die GetAlternateLocation-Methode ruft einen alternativen Speicherort für einen Dateisatz ab.

Syntax

HRESULT GetAlternateLocation(
  [out] BSTR *pbstrAlternateLocation
);

Parameter

[out] pbstrAlternateLocation

Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine Zeichenfolge empfängt, die den alternativen Sicherungsspeicherort angibt. Der Pfad dieses Speicherorts kann ein lokaler Pfad oder der UNC-Pfad einer Remotedateifreigabe sein. Wenn kein alternativer Speicherort vorhanden ist, ist der Zeiger NULL.

Rückgabewert

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

Wert	Bedeutung
S_OK	Die Informationen zum alternativen Speicherort wurden erfolgreich zurückgegeben.
S_FALSE	Die angeforderten Informationen konnten nicht gefunden werden.
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_UNEXPECTED	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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Remotedateifreigaben werden erst unter Windows 8 und Windows Server 2012 unterstützt.

Der Aufrufer muss SysFreeString aufrufen, um den arbeitsspeicher des pbstrAlternateLocation-Parameters freizugeben.

Die Interpretation des alternativen Speicherorts, der von GetAlternateLocation zurückgegeben wird, hängt von der Methode ab, die zum Abrufen des IVssWMFiledesc-Objekts verwendet wird.

• IVssExamineWriterMetadata::GetExcludeFile
• IVssWMComponent::GetDatabaseFile
• IVssWMComponent::GetDatabaseLogFile
• IVssWMComponent::GetFile

Der von GetAlternateLocation zurückgegebene Wert bezieht sich auf eine alternative Standortzuordnung, wenn er von der IVssExamineWriterMetadata::GetAlternateLocationMapping-Methode zurückgegeben wird.

Bei Sicherungsvorgängen ist dies der alternative Speicherort, von dem aus eine Datei gesichert werden soll. Während einer Wiederherstellung ist dies der alternative Speicherort, an dem eine Datei wiederhergestellt werden soll.

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

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 (enthalten Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssWMFiledesc