Metodo IVssSoftwareSnapshotProvider::IsVolumeSupported (vsprov.h)

Articolo
03/08/2023

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

Condividi tramite