enumerazione VSS_SNAPSHOT_CONTEXT (vss.h)

Articolo
03/08/2023

L'enumerazione _VSS_SNAPSHOT_CONTEXT consente a un richiedente di usare IVssBackupComponents::SetContext per specificare la modalità di creazione, query o eliminazione di una copia shadow e il grado di coinvolgimento del writer.

Sintassi

typedef enum _VSS_SNAPSHOT_CONTEXT {
  VSS_CTX_BACKUP = 0,
  VSS_CTX_FILE_SHARE_BACKUP,
  VSS_CTX_NAS_ROLLBACK,
  VSS_CTX_APP_ROLLBACK,
  VSS_CTX_CLIENT_ACCESSIBLE,
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS,
  VSS_CTX_ALL = 0xffffffff
} VSS_SNAPSHOT_CONTEXT, *PVSS_SNAPSHOT_CONTEXT;

Costanti


`VSS_CTX_BACKUP` Valore: 0 Contesto di backup standard. Specifica una copia ombreggiatura automatica, nonpersistente in cui gli autori sono coinvolto nella creazione.
`VSS_CTX_FILE_SHARE_BACKUP` Specifica una copia ombreggiatura automatica creata senza coinvolgimento del writer.
`VSS_CTX_NAS_ROLLBACK` Specifica una copia shadow di rilascio permanente e non automatica senza coinvolgimento del writer. Questo contesto deve essere usato quando non è necessario coinvolgere writer per garantire che i file si trovino in uno stato coerente al momento della copia shadow. Meccanismi di rollback di file automatizzati leggeri o copie shadow persistenti di condivisioni file o volumi di dati che non devono contenere file o database correlati al sistema potrebbero essere eseguiti in questo contesto. For ad esempio, un richiedente può usare questo contesto per creare una copia shadow di un volume NAS che ospita documenti e condivisioni utente semplici. Questi tipi di dati non richiedono il coinvolgimento del writer per creare una copia shadow coerente.
`VSS_CTX_APP_ROLLBACK` Specifica una copia shadow della versione persistente e non automatica con coinvolgimento del writer. Questo contesto è progettato da usare quando i writer sono necessari per assicurarsi che i file si trovino in uno stato ben definito prima della copia shadow. Meccanismi di rollback automatizzati dei volumi di sistema e delle copie shadow da usare nel data mining o nel ripristino le operazioni potrebbero essere eseguite in questo contesto. Questo contesto è simile a VSS_CTX_BACKUP ma consente al richiedente un maggiore controllo sulla persistenza della copia shadow.
`VSS_CTX_CLIENT_ACCESSIBLE` Specifica una copia shadow accessibile dal client di sola lettura che supporta copie shadow per cartelle condivise e viene creata senza coinvolgimento del writer. Solo il provider di sistema (il provider predefinito disponibile nel sistema) può creare questo tipo di copia shadow. La maggior parte dei richiedenti vuole usare il contesto di VSS_CTX_NAS_ROLLBACK per copie shadow persistenti e non di rilascio automatico senza coinvolgimento del writer.
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` Specifica una copia shadow accessibile dal client di sola lettura creata con il coinvolgimento del writer. Solo il provider di sistema (il provider predefinito disponibile nel sistema) può creare questo tipo di copia shadow. La maggior parte dei richiedenti vuole usare il contesto di VSS_CTX_APP_ROLLBACK per copie shadow persistenti e non di rilascio automatico con coinvolgimento del writer. Windows Server 2003 e Windows XP: Questo contesto non è supportato da Windows Server 2003 e Windows XP.
`VSS_CTX_ALL` Valore: 0xffffffff Tutti i tipi di copie shadow attualmente attive sono disponibili per le operazioni amministrative, ad esempio copia shadow query (vedere IVssBackupComponents::Query). VSS_CTX_ALL è un contesto valido per tutte le interfacce VSS, ad eccezione di IVssBackupComponents::StartSnapshotSet e IVssBackupComponents::D oSnapshotSet.

Commenti

Il tipo di dati da usare con valori di _VSS_SNAPSHOT_CONTEXT è LONG.

Il contesto predefinito per le copie shadow vsS è VSS_CTX_BACKUP.

Windows XP: L'unico contesto supportato è il valore predefinito VSS_CTX_BACKUP. La chiamata di IVssBackupComponents::SetContext restituirà E_NOTIMPL.

Per informazioni dettagliate sull'uso delle copie shadow di VSS, vedere Dettagli dell'implementazione per la creazione di copie shadow.

Il comportamento di copia shadow può essere ulteriormente controllato usando un or bit per bit per combinare un _VSS_VOLUME_SNAPSHOT_ATTRIBUTES supportato con valori di _VSS_SNAPSHOT_CONTEXT validi come argomento per il metodo IVssBackupComponents::SetContext .

Attualmente, le uniche modifiche supportate sono l'OR bit per bit di un valore _VSS_SNAPSHOT_CONTEXT con il VSS_VOLSNAP_ATTR_TRANSPORTABLEe il VSS_VOLSNAP_ATTR_DIFFERENTIALo il valore VSS_VOLSNAP_ATTR_PLEX dell'enumerazione _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

Tuttavia, questi valori non possono essere usati per modificare VSS_CTX_CLIENT_ACCESSIBLE contesto.

L'uso di VSS_VOLSNAP_ATTR_TRANSPORTABLE è limitato ai sistemi che eseguono Windows Server 2008 Enterprise, Windows Server 2008 Datacenter, Windows Server 2003, edizione Enterprise o Windows Server 2003, Datacenter Edition.