Partager via

Méthode IVssDifferentialSoftwareSnapshotMgmt ::QueryDiffAreasForVolume (vsmgmt.h)

  • Article

La méthode QueryDiffAreasForVolume interroge les zones de stockage de cliché instantané utilisées par le volume.

Syntaxe

HRESULT QueryDiffAreasForVolume(
  [in]  VSS_PWSZ           pwszVolumeName,
  [out] IVssEnumMgmtObject **ppEnum
);

Paramètres

[in] pwszVolumeName

Nom du volume qui contient des zones de stockage de clichés instantanés.

Le nom du volume 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 au format \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[out] ppEnum

Adresse d’un pointeur d’interface IVssEnumMgmtObject initialisé au retour. Les appelants doivent libérer l’interface.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur Signification
S_OK
 Interrogation réussie des zones de stockage de clichés instantanés.
E_ACCESSDENIED
 L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_PROVIDER_VETO
 Erreur du fournisseur : le fournisseur a enregistré l’erreur dans le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
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

L’objet énumérateur IVssEnumMgmtObject retourné contiendra VSS_DIFF_AREA_PROP structures à l’intérieur de l’union VSS_MGMT_OBJECT_UNION à l’intérieur de la structure VSS_MGMT_OBJECT_PROP .

Configuration requise

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

Voir aussi

IVssDifferentialSoftwareSnapshotMgmt

IVssEnumMgmtObject