Metodo IVssDifferentialSoftwareSnapshotMgmt3::SetVolumeProtectLevel (vsmgmt.h)

Articolo
03/13/2024

Imposta il livello di protezione della copia shadow per un volume originale o un volume dell'area di archiviazione della copia shadow.

Sintassi

HRESULT SetVolumeProtectLevel(
  [in] VSS_PWSZ             pwszVolumeName,
  [in] VSS_PROTECTION_LEVEL protectionLevel
);

Parametri

[in] pwszVolumeName

Il nome del volume. Questo parametro è obbligatorio e non può essere NULL.

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] protectionLevel

Valore dell'enumerazione VSS_PROTECTION_LEVEL che specifica il livello di protezione della copia shadow.

Valore restituito

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

Valore	Significato
S_OK	Il livello di protezione della copia shadow è stato impostato correttamente.
E_ACCESSDENIED 0x80070005L	Il chiamante non è un amministratore.
E_INVALIDARG 0x80070057L	Uno dei valori dei parametri non è valido.
E_NOTIMPL 0x80000001L	Il provider per il volume non supporta la protezione della copia shadow.
VSS_E_PROVIDER_VETO 0x80042306L	Si è verificato un errore previsto del provider. Il codice di errore viene registrato nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	Impossibile trovare il volume specificato.

Commenti

Il metodo SetVolumeProtectLevel controlla il livello di protezione della copia shadow corrente del volume. Se il volume è in stato di errore e VSS_PROTECTION_LEVEL_ORIGINAL_VOLUME viene specificato per il parametro protectionLevel , SetVolumeProtectLevel smonta il volume prima di impostare il livello di protezione.

Se il livello di protezione corrente del volume corrisponde al valore del parametro protectionLevel , SetVolumeProtectLevel non esegue alcuna operazione.

Se il valore del parametro protectionLevel è VSS_PROTECTION_LEVEL_SNAPSHOT, i richiedenti devono impostare associazioni dell'area di archiviazione della copia shadow (area diff) usando il metodo IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsmgmt.h

Vedi anche

IVssDifferentialSoftwareSnapshotMgmt3

IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel

Condividi tramite