Metodo IVssSoftwareSnapshotProvider::BeginPrepareSnapshot (vsprov.h)

  • Articolo

VSS chiama questo metodo per ogni copia shadow aggiunta al set di copie shadow.

Sintassi

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszVolumeName,
  [in] LONG     lNewContext
);

Parametri

[in] SnapshotSetId

Identificatore del set di copie shadow.

[in] SnapshotId

Identificatore della copia shadow da creare.

[in] pwszVolumeName

Stringa di caratteri wide con terminazione Null contenente il nome del volume. Il nome deve essere in uno dei formati seguenti e deve includere una barra rovesciata finale (\):

  • Percorso di una cartella montata, ad esempio Y:\MountX\
  • Lettera di unità, ad esempio D:\
  • Percorso GUID del volume nel formato \\?\Volume{GUID}\ (dove GUID identifica il volume)

[in] lNewContext

Contesto del set di copie shadow. Questo contesto è costituito da una maschera di bit di valori _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore Significato
S_OK
 La copia shadow è stata creata 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_OBJECT_NOT_FOUND
 Impossibile trovare il volume specificato.
VSS_E_PROVIDER_VETO
 Errore del provider. Il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNSUPPORTED_CONTEXT
 Il contesto specificato non è supportato.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
 Il provider non supporta il volume specificato.
VSS_E_UNEXPECTED
 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.

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