Méthode IVssDifferentialSoftwareSnapshotMgmt2 ::ChangeDiffAreaMaximumSizeEx (vsmgmt.h)

Article
08/27/2023

Mises à jour la taille maximale de la zone de stockage de cliché instantané pour un certain volume. Cela n’aura peut-être pas d’effet immédiat. Si le paramètre bVolatile a la valeur FALSE, la modification continue même si l’ordinateur est redémarré.

Syntaxe

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

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\
Lettre de lecteur, par exemple, D :\
Chemin d’accès GUID de volume de la forme \\ ?\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é
Lettre de lecteur avec, par exemple, D :\
Chemin d’accès GUID de volume de la forme \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[in] llMaximumDiffSpace

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

[in] bVolatile

TRUE pour indiquer que l’effet de l’appel de la méthode ChangeDiffAreaMaximumSizeEx ne doit pas se poursuivre si l’ordinateur est redémarré ; sinon, FALSE.

La valeur par défaut est FALSE.

Si le paramètre llMaximumDiffSpace est égal à zéro, le paramètre bVolatile doit être FALSE.

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 de cliché instantané 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 pas 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 n’a pas été trouvée.
VSS_E_PROVIDER_VETO	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_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é instantané.

Remarques

La méthode ChangeDiffAreaMaximumSizeEx est identique à la méthode IVssDifferentialSoftwareSnapshotMgmt ::ChangeDiffAreaMaximumSize, à l’exception du paramètre bVolatile .

Appeler la méthode ChangeDiffAreaMaximumSizeEx avec le paramètre bVolatile défini sur FALSE revient à appeler la méthode ChangeDiffAreaMaximumSize .

ChangeDiffAreaMaximumSizeEx rend la zone de stockage de cliché instantané 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 de cliché instantané n’existe pas, cette méthode la crée.

Windows Server 2008, Windows Vista et Windows Server 2003 : Si la zone de stockage de cliché instantané 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 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsmgmt.h

Voir aussi

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt ::ChangeDiffAreaMaximumSize

Partager via