Metodo IVssCreateExpressWriterMetadata::SetRestoreMethod (vswriter.h)

Articolo
08/27/2023

Specifica il modo in cui devono essere ripristinati i dati di un writer express.

Sintassi

HRESULT SetRestoreMethod(
  [in] VSS_RESTOREMETHOD_ENUM method,
  [in] LPCWSTR                wszService,
  [in] LPCWSTR                wszUserProcedure,
  [in] VSS_WRITERRESTORE_ENUM writerRestore,
  [in] bool                   bRebootRequired
);

Parametri

[in] method

Valore di enumerazione VSS_RESTOREMETHOD_ENUM che specifica il metodo di ripristino da utilizzare nell'operazione di ripristino. Questo parametro è obbligatorio e non può essere VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION o VSS_RME_CUSTOM.

[in] wszService

Puntatore a una stringa di caratteri wide contenente il nome di un servizio che deve essere arrestato prima di un'operazione di ripristino e quindi avviato dopo l'esecuzione dell'operazione di ripristino, se il valore del metodo è VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START.

Se il valore del metodo non è VSS_RME_STOP_RESTORE_START o VSS_RME_RESTORE_STOP_START, questo parametro non viene usato e deve essere impostato su NULL.

[in] wszUserProcedure

Riservato per utilizzi futuri. Il valore di questo parametro deve essere sempre impostato su NULL.

[in] writerRestore

Valore di enumerazione VSS_WRITERRESTORE_ENUM che specifica se il writer sarà coinvolto nel ripristino dei dati. Questo parametro deve essere impostato su VSS_WRE_NEVER.

[in] bRebootRequired

Valore booleano che indica se sarà necessario un riavvio al termine dell'operazione di ripristino.

Valore restituito

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

Valore	Significato
S_OK	L'operazione è stata completata.
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

Un writer express può definire un solo metodo di ripristino. Se il metodo di ripristino non viene sottoposto a override, tutti i componenti del writer express verranno ripristinati usando lo stesso metodo.

I writer express eseguono l'override del metodo di ripristino in base al componente impostando una destinazione di ripristino, in genere gestendo un evento PreRestore (CVssWriter::OnPreRestore).

È importante notare che, nonostante il fatto che i metodi di ripristino vengono applicati in base al writer, i metodi vengono implementati per ogni componente. Ad esempio, se il metodo specificato dal parametro del metodo è VSS_RME_RESTORE_IF_CAN_REPLACE, tutti i file nel componente vengono ripristinati nel percorso originale se possono essere tutti sostituiti senza errori. In caso contrario, vengono ripristinati nella posizione alternativa se ne viene specificata una.

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 su disco.
Il metodo di ripristino è VSS_RME_RESTORE_IF_CAN_REPLACE e una versione del file è presente sul disco e non può essere sostituita.

Se non viene definito alcun mapping di percorso alternativo valido, si tratta di un errore del writer.

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, è necessario specificare il nome corretto del servizio come argomento wszService . 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 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssCreateExpressWriterMetadata

Condividi tramite