enumerazione VSS_RESTORE_TARGET (vswriter.h)

Articolo
08/27/2023

L'enumerazione VSS_RESTORE_TARGET viene usata da un writer al momento del ripristino per indicare come tutti i file inclusi in un componente selezionato e tutti i file in qualsiasi set di componenti che definisce, devono essere ripristinati. Per informazioni sulla selezione dei componenti, vedere Uso della selezionabilità e dei percorsi logici .

L'impostazione di una destinazione di ripristino modifica o esegue l'override del set di metodi di ripristino durante il backup (vedere VSS_RESTOREMETHOD_ENUM).

Sintassi

typedef enum VSS_RESTORE_TARGET {
  VSS_RT_UNDEFINED = 0,
  VSS_RT_ORIGINAL,
  VSS_RT_ALTERNATE,
  VSS_RT_DIRECTED,
  VSS_RT_ORIGINAL_LOCATION
} ;

Costanti


`VSS_RT_UNDEFINED` Valore: 0 Nessuna destinazione è definita. Questo valore indica un errore nella parte del writer. Questo valore non è supportato per i writer express.
`VSS_RT_ORIGINAL` Si tratta della destinazione di ripristino predefinita. Questo valore indica che il ripristino dei file inclusi in un componente selezionato (o il set di componenti) definito da tale componente) deve procedere in base al metodo di ripristino originale specificato al momento del backup valore VSS_RESTOREMETHOD_ENUM .
`VSS_RT_ALTERNATE` I file vengono ripristinati in un percorso determinato da un mapping di percorso alternativo esistente. La destinazione di ripristino deve essere impostata su VSS_RT_ALTERNATE solo quando la posizione alternativa I mapping sono stati impostati per tutti i file gestiti da un componente o un set di componenti selezionati. Questo valore non è supportato per i writer express.
`VSS_RT_DIRECTED` Usare la destinazione diretta dal writer in fase di ripristino per ripristinare un file. La destinazione diretta consente a un writer di controllare, in base a un file per file, il modo in cui un file è ripristinato: indica la quantità di un file da ripristinare e in quali file il file di backup deve essere ripristinato. Questo valore non è supportato per i writer express.
`VSS_RT_ORIGINAL_LOCATION` I file vengono ripristinati nel percorso in cui erano in fase di backup, anche se l'originale metodo di ripristino specificato in fase di backup VSS_RME_RESTORE_TO_ALTERNATE_LOCATION. Windows Server 2003 e Windows XP: Questo valore non è supportato. Questo valore non è supportato per i writer express.

Commenti

Una destinazione di VSS_RT_UNDEFINED indica uno stato di errore.

In fase di backup, i writer impostano il comportamento di ripristino predefinito indicando un metodo di ripristino (VSS_RESTOREMETHOD_ENUM) impostato con IVssCreateWriterMetadata::SetRestoreMethod.

Se un writer non imposta in modo esplicito la destinazione di ripristino di un componente e qualsiasi componente impostato, per impostazione predefinita è impostata su VSS_RT_ORIGINAL.

Al momento del ripristino, un valore VSS_RESTORE_TARGET diverso da VSS_RT_ORIGINAL esegue l'override del valore del metodo di ripristino specificato in origine specificato da VSS_RESTOREMETHOD_ENUM e impostato da IVssCreateWriterMetadata::SetRestoreMethod.

Solo i writer (usando IVssComponent::SetRestoreTarget) possono impostare una destinazione di ripristino (VSS_RESTORE_TARGET) e modificare il modo in cui i file vengono ripristinati eseguendo l'override del metodo di ripristino.

I richiedenti e i writer possono accedere alla destinazione di ripristino corrente tramite IVssComponent::GetRestoreTarget.

Una destinazione di ripristino di VSS_RT_ORIGINAL non significa che i file devono essere ripristinati nel percorso originale, ma che il metodo di ripristino specificato originariamente (VSS_RESTOREMETHOD_ENUM) deve essere rispettato. Ad esempio, se un writer imposta un metodo di ripristino di VSS_RME_RESTORE_TO_ALTERNATE_LOCATION per un componente selezionato e la destinazione di ripristino è VSS_RT_ORIGINAL, i file devono essere ripristinati nel percorso alternativo definito dal writer.

In questo esempio, se un writer non è riuscito a definire mapping di percorsi alternativi, si tratta di un errore writer e il richiedente deve segnalarlo.

Una destinazione di ripristino di VSS_RT_ALTERNATE senza un mapping di percorso alternativo definito costituisce un errore writer e il richiedente deve segnalarlo come tale.

Per altre informazioni, vedere Backup e percorsi di ripristino non predefiniti .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	vswriter.h

Vedi anche

IVssComponent::GetRestoreTarget

IVssComponent::SetRestoreTarget

VSS_RESTOREMETHOD_ENUM

Condividi tramite