Metodo IVssSoftwareSnapshotProvider::SetContext (vsprov.h)
Imposta il contesto per le operazioni successive 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 combinazione supportata di valori di _VSS_VOLUME_SNAPSHOT_ATTRIBUTES e _VSS_SNAPSHOT_CONTEXT .
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Il contesto è stato impostato correttamente. |
|
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Il contesto è bloccato e non può essere modificato. |
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.
Per altre informazioni su come il contesto impostato da SetContext influisce sul modo in cui viene creata e gestita una copia shadow, vedere Dettagli dell'implementazione per la creazione di copie shadow.
Per una discussione completa sui contesti di copia shadow consentiti, vedere _VSS_SNAPSHOT_CONTEXT e _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vsprov.h |
| Libreria | VssApi.lib |