Funzione IsVolumeSnapshotted (vsbackup.h)

Articolo
08/27/2023

La funzione IsVolumeSnapshotted determina se esistono copie shadow per il volume specificato.

Nota Questa funzione viene esportata come IsVolumeSnapshottedInternal, ma è necessario chiamare IsVolumeSnapshotted, non IsVolumeSnapshottedInternal.

Sintassi

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

Parametri

[in] pwszVolumeName

Nome del volume. Il nome del volume da controllare 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

Il valore di questo parametro è TRUE se il volume ha una copia shadow e FALSE se il volume non dispone di una copia shadow.

[out] plSnapshotCapability

Maschera di bit (o OR bit per bit) di valori VSS_SNAPSHOT_COMPATIBILITY che indica se determinate operazioni di I/O o controllo del volume sono disabilitate per il volume specificato se esiste una copia shadow.

Valore restituito

I valori restituiti elencati di seguito sono oltre ai normali VALORI HRESULTCOM che possono essere restituiti in qualsiasi momento dalla funzione.

Valore	Significato
S_OK	La funzione è stata completata correttamente.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente o altre risorse di sistema.
VSS_E_PROVIDER_VETO	Errore previsto 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_OBJECT_NOT_FOUND	Impossibile trovare il volume specificato.
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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Errore imprevisto del provider. Il codice di errore viene registrato nel file di registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.

Commenti

Prima di chiamare questa funzione, il chiamante deve avere inizializzato COM chiamando la funzione CoInitialize .

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 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
DLL	VssApi.dll

Vedi anche

VSS_SNAPSHOT_COMPATIBILITY

Condividi tramite