Funzione IsVolumeSnapshottedInternal (vsbackup.h)

Articolo
03/03/2024

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 IsVolumeSnapshottedInternal(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCapability
);

Parametri

[in] pwszVolumeName

Nome del volume. Il nome del volume da controllare deve essere incluso 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] pbSnapshotsPresent

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

[out] plSnapshotCapability

Maschera bit (o OR bit per bit) di valori VSS_SNAPSHOT_COMPATIBILITY che indica se alcune operazioni di I/O del volume o di 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 s 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	Il volume specificato non è stato trovato.
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 del provider imprevisto. Il codice di errore viene registrato nel file di log 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 non sono disabilitate operazioni di I/O per il volume selezionato, la funzionalità di copia shadow del volume selezionato restituita 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