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

Article
03/06/2024

La méthode ChangeDiffAreaMaximumSize met à jour la taille maximale de la zone de stockage de clichés instantanés pour un certain volume. Cela peut ne pas avoir d’effet immédiat.

Syntaxe

HRESULT ChangeDiffAreaMaximumSize(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Paramètres

[in] pwszVolumeName

Nom du volume qui est la source des clichés instantanés. Ce volume est associé à une zone de stockage de cliché instantané sur le volume pwszDiffAreaVolumeName .

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)

[in] pwszDiffAreaVolumeName

Nom du volume qui contient la zone de stockage de cliché instantané associée au volume pwszVolumeName .

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

[in] llMaximumDiffSpace

Spécifie la taille maximale, en octets, pour la zone de stockage de clichés instantanés à utiliser pour le volume. Si cette valeur est égale à zéro, la zone de stockage de clichés instantanés est supprimée. Si cette valeur est –1, la taille maximale est illimitée.

Valeur retournée

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

Valeur	Signification
S_OK	La taille maximale de la zone de stockage des clichés instantanés a été modifiée.
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_INSUFFICIENT_STORAGE	Le volume pwszDiffAreaVolumeName n’a pas suffisamment d’espace libre.
VSS_E_OBJECT_NOT_FOUND	L’association entre les volumes pwszVolumeName et pwszDiffAreaVolumeName est introuvable.
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.
VSS_E_VOLUME_IN_USE	Un cliché instantané utilise actuellement la zone de stockage de clichés instantanés.

Remarques

La méthode ChangeDiffAreaMaximumSize rend la zone de stockage de clichés instantanés explicite, ce qui signifie qu’elle n’est pas supprimée automatiquement lorsque tous les clichés instantanés sont supprimés.

Si la zone de stockage des clichés instantanés n’existe pas, cette méthode la crée.

Windows Server 2008, Windows Vista et Windows Server 2003 : Si la zone de stockage des clichés instantanés n’existe pas, cette méthode ne la crée pas.

Pour créer une zone de stockage de cliché instantané, utilisez la méthode IVssDifferentialSoftwareSnapshotMgmt ::AddDiffArea .

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

Partager via