Metodo IVssBackupComponents::IsVolumeSupported (vsbackup.h)

Articolo
03/03/2024

Il metodo IsVolumeSupported determina se il provider specificato supporta copie shadow nel volume o nella condivisione file remota specificata.

Sintassi

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

Parametri

[in] ProviderId

Identificatore del provider. Se il valore è GUID_NULL, IsVolumeSupported verifica se qualsiasi provider supporta il volume o la condivisione file remota.

[in] pwszVolumeName

Nome del volume o percorso UNC della condivisione file remota. Il nome o il percorso UNC devono trovarsi in uno dei formati seguenti e devono 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)
Percorso UNC che specifica una condivisione file remota, ad esempio \\Clusterx\Share1\

[out] pbSupportedByThisProvider

Indirizzo di una variabile allocata dal chiamante che riceve TRUE se le copie shadow sono supportate nel volume o nella condivisione file remota specificata o false in caso contrario.

Valore restituito

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

Valore	Significato
S_OK	È stato restituito correttamente le informazioni sul supporto del provider.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
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_BAD_STATE	L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino o questo metodo non è stato chiamato all'interno della sequenza corretta.
VSS_E_OBJECT_NOT_FOUND	Il volume o la condivisione file remota specificati non sono stati trovati o non sono stati disponibili.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012.

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.

Nota Per altre informazioni sul numero massimo di copie shadow che possono essere create in un volume, vedere la voce per MaxShadowCopies in Chiavi e valori del Registro di sistema per il backup e il ripristino.

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

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssBackupComponents

IVssBackupComponents::AddToSnapshotSet

Condividi tramite