Funzione ShouldBlockRevert (vsbackup.h)

Articolo
08/27/2023

Controlla il Registro di sistema per i writer che devono bloccare le operazioni di ripristino nel volume specificato.

Nota Questa funzione è disponibile solo nei sistemi operativi Windows Server.

Sintassi

HRESULT ShouldBlockRevert(
  [in]  LPCWSTR wszVolumeName,
  [out] bool    *pbBlock
);

Parametri

[in] wszVolumeName

Il nome del volume. Questo 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] pbBlock

Puntatore a una variabile che riceve true se il volume contiene componenti di qualsiasi writer elencato nel Registro di sistema come writer che deve bloccare le operazioni di ripristino o false in caso contrario.

Valore restituito

Questa funzione può restituire uno di questi valori.

Valore	Significato
S_OK	Funzione completata.
E_ACCESSDENIED	Il chiamante 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_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

L'elenco di writer che devono bloccare le operazioni di ripristino viene archiviato nel Registro di sistema nella chiave seguente:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VSS\Settings\WritersBlockingRevert

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib
DLL	VssApi.dll

Condividi tramite