Metodo IVssBackupComponents::SetContext (vsbackup.h)
Il metodo SetContext imposta il contesto per le successive operazioni correlate alla copia shadow.
Sintassi
HRESULT SetContext(
[in] LONG lContext
);
Parametri
[in] lContext
Contesto da impostare. Il contesto deve essere uno dei valori supportati di _VSS_SNAPSHOT_CONTEXT o una maschera di bit supportata (o OR bit per bit) di _VSS_VOLUME_SNAPSHOT_ATTRIBUTES con un _VSS_SNAPSHOT_CONTEXT valido.
Valore restituito
Il valore restituito predefinito di questo metodo è S_OK. Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Impostare correttamente il contesto. |
|
Uno dei valori dei parametri non è valido. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato. |
Commenti
Il contesto predefinito per le copie shadow vss è VSS_CTX_BACKUP.
Windows XP: L'unico contesto supportato è il contesto predefinito, VSS_CTX_BACKUP. Pertanto, la chiamata a SetContext in Windows XP restituisce E_NOTIMPL.
SetContext può essere chiamato una sola volta e deve essere chiamato prima di chiamare la maggior parte delle funzioni VSS.
Per informazioni dettagliate su come viene creato e gestito il contesto impostato da IVssBackupComponents::SetContext , vedere Dettagli di implementazione per la creazione di copie shadow.
Per una descrizione completa dei contesti di copia shadow consentiti, vedere _VSS_SNAPSHOT_CONTEXT e _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |
Vedi anche
IVssBackupComponents::D oSnapshotSet