Metodo IVssWMFiledesc::GetAlternateLocation (vswriter.h)

Il metodo GetAlternateLocation ottiene un percorso alternativo per un set di file.

Sintassi

HRESULT GetAlternateLocation(
  [out] BSTR *pbstrAlternateLocation
);

Parametri

[out] pbstrAlternateLocation

Indirizzo di una variabile allocata dal chiamante che riceve una stringa che specifica il percorso di backup alternativo. Il percorso di questo percorso può essere un percorso locale o il percorso UNC di una condivisione file remota. Se non esiste una posizione alternativa, il puntatore è NULL.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Sono state restituite correttamente le informazioni sulla posizione alternativa.
S_FALSE	Impossibile trovare le informazioni richieste.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012.

Il chiamante deve chiamare SysFreeString per liberare la memoria contenuta nel parametro pbstrAlternateLocation .

L'interpretazione della posizione alternativa restituita da GetAlternateLocation varia a seconda del metodo usato per recuperare l'oggetto IVssWMFiledesc .

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

Il valore restituito da GetAlternateLocation fa riferimento a un mapping di posizione alternativo quando restituito dal metodo IVssExamineWriterMetadata::GetAlternateLocationMapping .

Durante le operazioni di backup, si tratta del percorso alternativo da cui eseguire il backup di un file. Durante un ripristino, si tratta del percorso alternativo in cui ripristinare un file.

Per altre informazioni, vedere Percorsi di backup e ripristino non predefiniti.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssWMFiledesc