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

Article
08/27/2023

La méthode AddDiffArea ajoute une association de zone de stockage de cliché instantané pour le volume spécifié. Si l’association n’est pas prise en charge, un code d’erreur est retourné.

Syntaxe

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

Paramètres

[in] pwszVolumeName

Nom du volume qui sera 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 contiendra la zone de stockage de cliché instantané à associer 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

Taille maximale, en octets, de la zone de stockage de clichés instantanés sur le volume. Cette valeur doit être d’au moins 320 Mo, jusqu’à la limite à l’échelle du système. Si cette valeur est –1, la taille maximale est illimitée.

Windows Server 2003 : Avant Windows Server 2003 avec SP1, la taille de la zone de stockage des clichés instantanés était fixée à 100 Mo.

Valeur retournée

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

Valeur	Signification
S_OK	Ajout de l’association de zone de stockage de cliché instantané.
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_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED	Le nombre maximal de zones de stockage de clichés instantanés a été ajouté au volume source de clichés instantanés. Le volume de stockage de clichés instantanés spécifié n’a pas été associé au volume source de cliché instantané spécifié.
VSS_E_NESTED_VOLUME_LIMIT	Le volume spécifié est imbriqué trop profondément pour participer à l’opération VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Ce code de retour n’est pas pris en charge.
VSS_E_OBJECT_ALREADY_EXISTS	L’association entre les volumes pwszVolumeName et pwszDiffAreaVolumeName existe déjà.
VSS_E_PROVIDER_VETO	Erreur du fournisseur attendue. 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_NOT_SUPPORTED	Le volume pwszDiffAreaVolumeName n’est pas un volume NTFS ou a un espace libre insuffisant.

Remarques

Impossible de créer une association de zone de stockage de cliché instantané si des clichés instantanés existent déjà pour le volume pwszVolumeName ou s’il existe déjà une association de zone de stockage de cliché instantané pour ce volume.

La zone de stockage de cliché instantané d’un volume source de disque dur virtuel (VHD) doit résider sur le même volume. De même, une zone de stockage de cliché instantané ne peut être créée que sur un volume de disque dur virtuel si le volume source est le même pour les deux volumes.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Les disques durs virtuels ne sont pas pris en charge.

Pour modifier la taille d’une zone de stockage de cliché instantané, utilisez la méthode IVssDifferentialSoftwareSnapshotMgmt ::ChangeDiffAreaMaximumSize ou IVssDifferentialSoftwareSnapshotMgmt2 ::ChangeDiffAreaMaximumSizeEx . Vous pouvez supprimer une zone de stockage de clichés instantanés en remplaçant sa taille par zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
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