Metodo IVssSoftwareSnapshotProvider::IsVolumeSnapshotted (vsprov.h)

Articolo
03/03/2024

Determina se sono presenti copie shadow per il volume specificato.

Sintassi

HRESULT IsVolumeSnapshotted(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCompatibility
);

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

[out] pbSnapshotsPresent

Questo parametro riceve TRUE se il volume dispone di una copia shadow o FALSE se il volume non dispone di una copia shadow.

[out] plSnapshotCompatibility

Maschera di bit di VSS_SNAPSHOT_COMPATIBILITY valori che indicano se determinate operazioni di I/O del volume o di controllo del volume sono disabilitate per il volume specificato, se il volume dispone di una copia shadow.

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.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_OBJECT_NOT_FOUND	Impossibile trovare il volume specificato.
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

Se nessun controllo del volume o operazioni di I/O del file è disabilitato per il volume selezionato, la funzionalità di copia shadow del volume selezionato restituito da plSnapshotCapability sarà zero.

Requisiti

Requisito	Valore
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