Metodo IVssSoftwareSnapshotProvider::SetContext (vsprov.h)

  • Articolo

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
S_OK
 Il contesto è stato impostato correttamente.
E_ACCESSDENIED
 Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
 Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE
 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

Vedi anche

IVssSoftwareSnapshotProvider