Fonction ShouldBlockRevert (vsbackup.h)

Article
08/27/2023

Recherche dans le Registre des enregistreurs qui doivent bloquer les opérations de restauration sur le volume spécifié.

Note Cette fonction n’est disponible que sur les systèmes d’exploitation Windows Server.

Syntaxe

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

Paramètres

[in] wszVolumeName

Nom du volume. Ce nom doit être dans l’un des formats suivants et doit inclure une barre oblique inverse de fin (\) :

Chemin d’accès d’un dossier monté, par exemple, Y:\MountX\
Lettre de lecteur, par exemple, D:\
Chemin d’accès GUID de volume de la forme \\?\Volume{GUID}\ (où GUID identifie le volume)

[out] pbBlock

Pointeur vers une variable qui reçoit true si le volume contient des composants de tous les enregistreurs répertoriés dans le Registre en tant qu’enregistreurs qui doivent bloquer les opérations de restauration, ou false dans le cas contraire.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La fonction a réussi.
E_ACCESSDENIED	L’appelant n’est pas un administrateur.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_UNEXPECTED	Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place.

Remarques

La liste des rédacteurs qui doivent bloquer les opérations de restauration est stockée dans le Registre sous la clé suivante :

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

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib
DLL	VssApi.dll

Partager via