Méthode IVssDifferentialSoftwareSnapshotMgmt3 ::SetVolumeProtectLevel (vsmgmt.h)

Définit le niveau de protection contre les clichés instantanés pour un volume d’origine ou un volume de zone de stockage de clichés instantanés.

Syntaxe

HRESULT SetVolumeProtectLevel(
  [in] VSS_PWSZ             pwszVolumeName,
  [in] VSS_PROTECTION_LEVEL protectionLevel
);

Paramètres

[in] pwszVolumeName

Nom du volume. Ce paramètre est obligatoire et ne peut pas être NULL.

Le 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\
  • Une lettre de lecteur, par exemple, D :\
  • Chemin d’accès guid du volume sous la forme \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[in] protectionLevel

Valeur de l’énumération VSS_PROTECTION_LEVEL qui spécifie le niveau de protection contre les clichés instantanés.

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur Signification
S_OK
Le niveau de protection contre les clichés instantanés a été correctement défini.
E_ACCESSDENIED
0x80070005L
L’appelant n’est pas un administrateur.
E_INVALIDARG
0x80070057L
L’une des valeurs de paramètre n’est pas valide.
E_NOTIMPL
0x80000001L
Le fournisseur du volume ne prend pas en charge la protection contre les clichés instantanés.
VSS_E_PROVIDER_VETO
0x80042306L
Une erreur de fournisseur attendue s’est produite. Le code d’erreur est consigné dans le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
Le volume spécifié est introuvable.

Remarques

La méthode SetVolumeProtectLevel vérifie le niveau actuel de protection contre les clichés instantanés du volume. Si le volume est dans un état d’erreur et que VSS_PROTECTION_LEVEL_ORIGINAL_VOLUME est spécifié pour le paramètre protectionLevel , SetVolumeProtectLevel démonte le volume avant de définir le niveau de protection.

Si le niveau de protection actuel du volume est identique à la valeur du paramètre protectionLevel , SetVolumeProtectLevel ne fait rien.

Si la valeur du paramètre protectionLevel est VSS_PROTECTION_LEVEL_SNAPSHOT, les demandeurs doivent définir des associations de zone de stockage de cliché instantané (diff zone) à l’aide de la méthode IVssDifferentialSoftwareSnapshotMgmt ::AddDiffArea.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vsmgmt.h

Voir aussi

IVssDifferentialSoftwareSnapshotMgmt3

IVssDifferentialSoftwareSnapshotMgmt3 ::GetVolumeProtectLevel