Metodo IVssSoftwareSnapshotProvider::IsVolumeSupported (vsprov.h)

  • Articolo

Determina se il provider supporta copie shadow nel volume specificato.

Sintassi

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

Parametri

[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 del modulo \\?\Volume{GUID}\ (dove GUID identifica il volume)

[out] pbSupportedByThisProvider

Questo parametro riceve TRUE se le copie shadow sono supportate nel volume specificato, in caso contrario FALSE.

Valore restituito

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

Valore Significato
S_OK
 Le informazioni richieste sono state restituite 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.
VSS_E_NESTED_VOLUME_LIMIT
 Il volume specificato è annidato troppo profondamente per partecipare all'operazione VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo codice restituito non è supportato.
E_OUTOFMEMORY
 Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_OBJECT_NOT_FOUND
 Il volume specificato non è stato trovato.
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_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.

Commenti

Il metodo IsVolumeSupported restituirà TRUE se è possibile creare copie shadow nel volume specificato, anche se la configurazione corrente non consente la creazione di copie shadow nel volume corrente.

Ad esempio, se il numero massimo di copie shadow è stato raggiunto in un determinato volume (e quindi non è possibile creare copie shadow in tale volume), il metodo indicherà comunque che il volume può essere copiato dall'ombreggiatura.

Questo metodo non può essere chiamato per un disco rigido virtuale (VHD) annidato all'interno di un altro disco rigido virtuale.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: I dischi rigidi virtuali non sono supportati.

Requisiti

   
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