Metodo IVssExamineWriterMetadata::GetAlternateLocationMapping (vsbackup.h)

Articolo
03/08/2023

Il metodo GetAlternateLocationMapping ottiene un mapping di percorso alternativo specifico di un set di file.

Sintassi

HRESULT GetAlternateLocationMapping(
  [in]  UINT           iMapping,
  [out] IVssWMFiledesc **ppFiledesc
);

Parametri

[in] iMapping

Indice di un mapping specifico. Il valore di questo parametro è un numero intero compreso tra 0 e n-1 inclusi, dove n è il numero totale di mapping di percorsi alternativi associati a un determinato writer. Il valore di n viene restituito da IVssExamineWriterMetadata::GetRestoreMethod.

[out] ppFiledesc

Puntatore indiretto doubly a un oggetto IVssWMFiledesc contenente le informazioni di mapping della posizione alternative.

Valore restituito

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

Valore	Significato
S_OK	È stato restituito un puntatore a un'interfaccia IVssWMFiledesc .
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_OBJECT_NOT_FOUND	Il mapping del percorso alternativo specificato non esiste.
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

Il valore restituito da IVssExamineWriterMetadata::GetAlternateLocationMapping non deve essere confuso con quello restituito da IVssComponent::GetAlternateLocationMapping.

IVssComponent::GetAlternateLocationMapping è il percorso alternativo in cui è stato ripristinato un file.

IVssExamineWriterMetadata::GetAlternateLocationMapping è il mapping del percorso alternativo a cui un file può essere ripristinato, se necessario.

Un file deve essere sempre ripristinato nel relativo mapping di percorso alternativo se una delle condizioni seguenti è vera:

Il metodo di ripristino (impostato in fase di backup) è VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
La destinazione di ripristino è stata impostata (in fase di ripristino) su VSS_RT_ALTERNATE.

In entrambi i casi, se non viene definito alcun mapping di percorso alternativo valido, ciò costituisce un errore del writer.

Un file può essere ripristinato in un mapping di percorso alternativo se si verifica una delle condizioni seguenti:

Il metodo di ripristino è VSS_RME_RESTORE_IF_NOT_THERE e una versione del file è già presente sul disco.
Il metodo di ripristino è VSS_RME_RESTORE_IF_CAN_REPLACE e una versione del file è presente su disco e non può essere sostituita.

Anche in questo caso, se non viene definito alcun mapping di percorso alternativo valido, si tratta di un errore writer.

Un mapping di percorso alternativo viene usato solo durante un'operazione di ripristino e non deve essere confuso con un percorso alternativo, che viene usato solo durante un'operazione di backup.

Il chiamante è responsabile della chiamata di IUnknown::Release per rilasciare le risorse dell'oggetto IVssWMFiledesc restituito.

Requisiti


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

Vedi anche

IVssBackupComponents::AddAlternativeLocationMapping

IVssComponent::GetAlternateLocationMapping

IVssExamineWriterMetadata

IVssExamineWriterMetadata::GetRestoreMethod

IVssWMFiledesc

Condividi tramite