Partager via


Méthode IVssDifferentialSoftwareSnapshotMgmt3 ::D eleteUnusedDiffAreas (vsmgmt.h)

Supprime toutes les zones de stockage de cliché instantané (également appelées zones diff) sur le volume spécifié qui ne sont pas en cours d’utilisation.

Syntaxe

HRESULT DeleteUnusedDiffAreas(
  [in] VSS_PWSZ pwszDiffAreaVolumeName
);

Paramètres

[in] pwszDiffAreaVolumeName

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)

Valeur retournée

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

Valeur Signification
S_OK
Les zones de stockage de cliché instantané ont été supprimées.
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

Les fichiers de zone de stockage de cliché instantané inutilisés sont trouvés sur les volumes de zone de stockage lorsque le volume d’origine associé est hors connexion en raison d’une erreur de protection. Dans certains cas, le volume d’origine peut être définitivement perdu, et l’appel de la méthode DeleteUnusedDiffAreas est le seul moyen de récupérer l’espace de stockage abandonné.

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