Condividi tramite


enumerazione VSS_SNAPSHOT_CONTEXT (vss.h)

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.

Requisiti

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

Vedi anche

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES