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 |
---|---|
|
È stata eseguita una query sul livello di protezione della copia shadow. |
|
Il chiamante non è un amministratore. |
|
Uno dei valori dei parametri non è valido. |
|
Il provider per il volume non supporta la protezione della copia shadow. |
|
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. |
|
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