Condividi tramite


enumerazione VSS_VOLUME_SNAPSHOT_ATTRIBUTES (vss.h)

Consente di specificare attributi aggiuntivi per una copia shadow. Il contesto di una copia shadow (impostato dal metodo IVssBackupComponents::SetContext ) può essere modificato da una maschera di bit che contiene una combinazione valida di _VSS_VOLUME_SNAPSHOT_ATTRIBUTES e _VSS_SNAPSHOT_CONTEXT valori di enumerazione.

Sintassi

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

Costanti

 
VSS_VOLSNAP_ATTR_PERSISTENT
Valore: 0x1
La copia shadow è persistente tra i riavvii.


Questo attributo viene impostato automaticamente per
_VSS_SNAPSHOT_CONTEXT contesti di
VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE,
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS e
VSS_CTX_NAS_ROLLBACK.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_NO_AUTORECOVERY
Valore: 0x2
Il ripristino automatico è disabilitato per la copia shadow.

Un richiedente può modificare un contesto di copia shadow con un OR bit per bit di questo attributo. In questo modo, il richiedente indica al Servizio Copia Shadow di rendere la copia shadow di sola lettura immediatamente dopo la creazione, senza consentire ai writer o ad altre applicazioni di aggiornare i componenti nella copia shadow.

La disabilitazione del ripristino automatico può causare che la copia shadow si trovi in uno stato incoerente se uno dei relativi componenti è coinvolto nelle operazioni di database transazionali, ad esempio le operazioni di lettura e scrittura transazionali gestite da NTFS transazionale (TxF). Ciò è dovuto al fatto che la disabilitazione del ripristino automatico impedisce il rollback delle transazioni incomplete.

La disabilitazione del ripristino automatico impedisce anche ai writer di escludere i file dalla copia shadow. Quando il ripristino automatico è disabilitato, un writer può comunque chiamare il metodo IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot , ma il metodo CVssWriter::OnPostSnapshot del writer non può eliminare i file dalla copia shadow.

Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Vista.
VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE
Valore: 0x4
La copia shadow specificata è una copia shadow accessibile dal client che supporta copie shadow per cartelle condivise e non deve essere esposta.

Questo attributo viene impostato automaticamente per VSS_CTX_CLIENT_ACCESSIBLE e VSS_CTX_CLIENT_ACCESSIBLE_WRITERS.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE
Valore: 0x8
La copia shadow non viene eliminata automaticamente al termine del processo del richiedente della copia shadow. Copia shadow
può essere eliminato solo da una chiamata a
IVssBackupComponents::D eleteSnapshots.


Questo attributo viene impostato automaticamente per
_VSS_SNAPSHOT_CONTEXT contesti di
VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE,
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS e
VSS_CTX_NAS_ROLLBACK.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_NO_WRITERS
Valore: 0x10
Nessun writer è coinvolto nella creazione della copia shadow.


Questo attributo viene impostato automaticamente per
_VSS_SNAPSHOT_CONTEXT contesti di
VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP e
VSS_CTX_CLIENT_ACCESSIBLE.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_TRANSPORTABLE
Valore: 0x20
La copia shadow deve essere trasportata e pertanto non deve essere visualizzata localmente.


Questo attributo può essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow, se
provider per la copia shadow supporta copie shadow trasportabili.

Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition e Windows XP: Questo attributo non è supportato. Tutte le edizioni di Windows Server 2003 con SP1 supportano questo attributo.

Vedere Importazione di elementi trasportabili
Volumi copiati
shadow per altre informazioni.
VSS_VOLSNAP_ATTR_NOT_SURFACED
Valore: 0x40
La copia shadow non è attualmente esposta.


A meno che la copia shadow non sia esposta o montata in modo esplicito, questo attributo viene impostato per tutte le copie shadow.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_NOT_TRANSACTED
Valore: 0x80
La copia shadow non viene eseguita.

Un richiedente può modificare un contesto di copia shadow con un OR bit per bit di questo attributo. In questo modo, il richiedente indica a VSS di disabilitare l'integrazione predefinita tra VsS e gestione transazioni e risorse.

L'impostazione di questo attributo garantisce che il richiedente non riceva errori VSS_E_TRANSACTION_FREEZE_TIMEOUT. Tuttavia, può causare conseguenze indesiderate, ad esempio la perdita di integrità transazionale o persino la perdita di dati.

Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Vista.
VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED
Valore: 0x10000
Indica che un determinato provider è un provider hardware.


Questo attributo viene impostato automaticamente per i provider hardware.

Questo valore di enumerazione non può essere utilizzato per impostare manualmente il contesto (utilizzando
IVssBackupComponents::SetContext
metodo) di una copia shadow tramite una maschera di bit (o OR bit per bit) di questo valore di enumerazione e una copia shadow valida
valore di contesto da
_VSS_SNAPSHOT_CONTEXT.
VSS_VOLSNAP_ATTR_DIFFERENTIAL
Valore: 0x20000
Indica che un determinato provider usa dati differenziali o un meccanismo di copia su scrittura per implementare copie shadow.


Un richiedente può modificare un contesto di copia shadow con un OR bit per bit di questo attributo. In questo modo, il
il richiedente indica ai provider di creare una copia shadow usando un'implementazione differenziale. Se non è disponibile alcuna copia shadow
provider installato nel sistema supporta gli attributi richiesti, un errore di VSS_E_VOLUME_NOT_SUPPORTED sarà
restituito a
IVssBackupComponents::AddToSnapshotSet.
VSS_VOLSNAP_ATTR_PLEX
Valore: 0x40000
Indica che un determinato provider usa un meccanismo di divisione PLEX o con mirroring per implementare copie shadow.


Un richiedente può modificare un contesto di copia shadow con un OR bit per bit di questo attributo. In questo modo, il
il richiedente indica ai provider di creare una copia shadow usando un'implementazione PLEX. Se non è disponibile alcuna copia shadow
provider installato nel sistema supporta gli attributi richiesti, un errore di VSS_E_VOLUME_NOT_SUPPORTED sarà
restituito a
IVssBackupComponents::AddToSnapshotSet.
VSS_VOLSNAP_ATTR_IMPORTED
Valore: 0x80000
La copia shadow del volume è stata importata in questo computer usando
IVssBackupComponents::ImportSnapshots
invece di creare utilizzando
IVssBackupComponents::D oSnapshotSet
ProcessOnStatus.


Questo attributo viene impostato automaticamente se viene importata una copia shadow.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY
Valore: 0x100000
La copia shadow viene esposta localmente. Se questo flag di bit e il flag di bit VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY sono
non impostata, la copia shadow è nascosta.


L'attributo viene aggiunto automaticamente a un contesto di copia shadow al momento della chiamata a
IVssBackupComponents::ExposeSnapshot
per esporre una copia shadow in locale.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY
Valore: 0x200000
La copia shadow viene esposta in remoto. Se questo flag di bit e il flag di bit VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY sono
non impostata, la copia shadow è nascosta.


L'attributo viene aggiunto automaticamente a un contesto di copia shadow al momento della chiamata a
IVssBackupComponents::ExposeSnapshot
per esporre una copia shadow in locale.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_AUTORECOVER
Valore: 0x400000
Indica che il writer dovrà ripristinare automaticamente il componente in CVssWriter::OnPostSnapshot.

Questo attributo non deve essere usato in modo esplicito dai richiedenti quando si imposta il contesto di una copia shadow.
VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY
Valore: 0x800000
Indica che il writer dovrà ripristinare automaticamente il componente in CVssWriter::OnPostSnapshot se la copia shadow viene usata per il rollback, ad esempio per il data mining.

Un richiedente imposta questo flag nel contesto di copia shadow per indicare che la copia shadow viene creata per uno scopo non di backup, ad esempio il data mining.
VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT
Valore: 0x1000000
Riservato per l'utilizzo nel sistema.

Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008.
VSS_VOLSNAP_ATTR_TXF_RECOVERY
Valore: 0x2000000
Indica che il ripristino TxF deve essere applicato durante la creazione della copia shadow.

Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008.
VSS_VOLSNAP_ATTR_FILE_SHARE
Valore: 0x4000000

Commenti

Il contesto predefinito per le copie shadow vss è VSS_CTX_BACKUP.

Un richiedente imposta il contesto per la creazione di una copia shadow passando il membro dell'enumerazione _VSS_SNAPSHOT_CONTEXT al metodo IVssBackupComponents::SetContext .

I richiedenti possono modificare questo contesto usando un OR bit per bit del valore _VSS_SNAPSHOT_CONTEXT con un valore supportato dall'enumerazione _VSS_VOLUME_SNAPSHOT_ATTRIBUTES come argomento per IVssBackupComponents::SetContext.

A meno che non venga richiesto in modo specifico di supportare un determinato meccanismo, i provider sono liberi di usare qualsiasi tipo di meccanismo per implementare una copia shadow. Pertanto, nel caso in cui non venga specificato un metodo di copia shadow, il provider è libero di scegliere un meccanismo differenziale (VSS_VOLSNAP_ATTR_DIFFERENTIAL), un meccanismo PLEX (VSS_VOLSNAP_ATTR_PLEX) o qualsiasi altro meccanismo per supportare la copia shadow.

Anche se un provider può supportare entrambi i meccanismi, si escludono a vicenda per una determinata copia shadow. I richiedenti non devono usare sia VSS_VOLSNAP_ATTR_DIFFERENTIAL cheVSS_VOLSNAP_ATTR_PLEX per modificare un contesto di copia shadow specifico.

Attualmente, VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX e VSS_VOLSNAP_ATTR_TRANSPORTABLE sono gli unici valori dell'enumerazione _VSS_VOLUME_SNAPSHOT_ATTRIBUTES che può essere usata per modificare qualsiasi contesto.

Inoltre, non può essere usato per modificare un contesto di VSS_CTX_CLIENT_ACCESSIBLE .

Un richiedente può ottenere informazioni su una copia shadow specifica (identificata da VSS_ID) decomprimendo la struttura VSS_SNAPSHOT_PROP dalla struttura VSS_OBJECT_PROP restituita da una chiamata a IVssBackupComponents::GetSnapshotProperties.

Un richiedente può anche ottenere una struttura VSS_SNAPSHOT_PROP per ognuna di più copie shadow chiamando IVssBackupComponents::Query e usando IVssEnumObject per scorrere i valori restituiti.

Il contesto e gli attributi delle copie shadow si trovano come maschera di bit contenuta nel membro m_lSnapshotAttributes della struttura VSS_SNAPSHOT_PROP .

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione vss.h

Vedi anche

IVssBackupComponents::D eleteSnapshots

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::GetSnapshotProperties

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_SNAPSHOT_CONTEXT