enumerazione VSS_VOLUME_SNAPSHOT_ATTRIBUTES (vss.h)

Articolo
08/27/2023

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 .