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

Article
03/13/2024

Obtient le niveau de protection contre les clichés instantanés et status pour le volume spécifié.

Syntaxe

HRESULT GetVolumeProtectLevel(
  [in]  VSS_PWSZ                   pwszVolumeName,
  [out] VSS_VOLUME_PROTECTION_INFO *protectionLevel
);

Paramètres

[in] pwszVolumeName

Nom du volume. Ce paramètre est obligatoire et ne peut pas avoir la valeur 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\
Lettre de lecteur, par exemple, D :\
Chemin d’accès GUID de volume sous la forme \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[out] protectionLevel

Adresse d’une mémoire tampon allouée à l’appelant qui reçoit une structure VSS_VOLUME_PROTECTION_INFO contenant des informations sur le niveau de protection contre les clichés instantanés du volume.

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 interrogé.
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 0x800000001L	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 GetVolumeProtectLevel obtient des informations sur le niveau de protection actuel du volume. Si le volume est dans un état défectueux, le membre m_protectionFault de la structure VSS_VOLUME_PROTECTION_INFO contient l’erreur de protection actuelle et le membre m_failureStatus contient la raison pour laquelle le volume est dans un état défectueux. Si le volume n’est pas dans un état défectueux, les membres m_protectionFault et m_failureStatus sont zéro.

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 ::SetVolumeProtectLevel

Partager via