Metodo IVssExamineWriterMetadata::GetRestoreMethod (vsbackup.h)

Articolo
03/13/2024

Il metodo GetRestoreMethod restituisce informazioni sulla modalità di ripristino dei dati da parte di un writer.

Sintassi

HRESULT GetRestoreMethod(
  [out] VSS_RESTOREMETHOD_ENUM *pMethod,
  [out] BSTR                   *pbstrService,
  [out] BSTR                   *pbstrUserProcedure,
  [out] VSS_WRITERRESTORE_ENUM *pwriterRestore,
  [out] bool                   *pbRebootRequired,
  [out] UINT                   *pcMappings
);

Parametri

[out] pMethod

Puntatore a un valore VSS_RESTOREMETHOD_ENUM che specifica la sovrascrittura del file, l'uso di percorsi alternativi che specificano il metodo che verrà utilizzato nell'operazione di ripristino.

[out] pbstrService

Se il valore di pMethod è VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, un puntatore a una stringa contenente il nome del servizio avviato e arrestato. In caso contrario, il valore è NULL.

[out] pbstrUserProcedure

Puntatore all'URL di un documento HTML o XML che descrive all'utente la modalità di esecuzione del ripristino. Il valore può essere NULL.

[out] pwriterRestore

Puntatore a un valore VSS_WRITERRESTORE_ENUM che specifica se il writer sarà coinvolto nel ripristino dei dati.

[out] pbRebootRequired

Puntatore a un valore booleano che indica se sarà necessario un riavvio al termine dell'operazione di ripristino. Il valore riceve true se sarà necessario un riavvio o false in caso contrario.

[out] pcMappings

Puntatore al numero di mapping alternativi associati al writer.

Valore restituito

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

Valore	Significato
S_OK	Sono state restituite correttamente le informazioni sul metodo di ripristino.
S_FALSE	Un metodo di ripristino non esiste.
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

Il chiamante deve liberare la memoria usata dai parametri pbstrUserProcedure e pbstrService chiamando SysFreeString.

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 :

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.

Per altre informazioni sui metodi di ripristino, vedere Impostazione dei metodi di ripristino vss.

Se il metodo di ripristino è VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, un richiedente usa il nome restituito da pbstrService per determinare quale servizio deve essere arrestato durante e quindi riavviato dopo il ripristino. Per informazioni sulla partecipazione del writer all'arresto e al riavvio dei servizi durante un'operazione di ripristino, vedere Arresto dei servizi per il ripristino da parte dei richiedenti .

Requisiti

Requisito	Valore
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

IVssCreateWriterMetadata::SetRestoreMethod

IVssExamineWriterMetadata

Condividi tramite