Metodo IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel (vsmgmt.h)

Ottiene il livello di protezione della copia shadow e lo stato per il volume specificato.

Sintassi

HRESULT GetVolumeProtectLevel(
  [in]  VSS_PWSZ                   pwszVolumeName,
  [out] VSS_VOLUME_PROTECTION_INFO *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)

[out] protectionLevel

Indirizzo di un buffer allocato dal chiamante che riceve una struttura VSS_VOLUME_PROTECTION_INFO contenente informazioni sul livello di protezione della copia shadow del volume.

Valore restituito

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

Valore Significato
S_OK
È stata eseguita una query sul livello di protezione della copia shadow.
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 GetVolumeProtectLevel ottiene informazioni sul livello di protezione corrente del volume. Se il volume si trova in uno stato di errore, il membro m_protectionFault della struttura di VSS_VOLUME_PROTECTION_INFO contiene l'errore di protezione corrente e il membro m_failureStatus contiene il motivo per cui il volume si trova in uno stato di errore. Se il volume non è in uno stato con errori, i membri m_protectionFault e m_failureStatus saranno zero.

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::SetVolumeProtectLevel