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