Metodo IVssFileShareSnapshotProvider::SetContext (vsprov.h)

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 combinazione supportata di valori _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 in 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 sul modo in cui il contesto impostato da SetContext influisce sulla modalità di creazione e gestione di una copia shadow, 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 8.1 [solo app desktop]
Server minimo supportato Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vsprov.h
Libreria VssApi.lib

Vedi anche

IVssFileShareSnapshotProvider