Méthode IVssCreateWriterMetadataEx ::AddExcludeFilesFromSnapshot (vswriter.h)

  • Article

Signale tous les jeux de fichiers qui seront explicitement exclus par l’enregistreur lors de la création d’un cliché instantané.

L’appel de cette méthode n’entraîne pas l’exclusion des fichiers. L’enregistreur est chargé de supprimer les fichiers du cliché instantané dans sa méthode CVssWriter ::OnPostSnapshot .

Syntaxe

HRESULT AddExcludeFilesFromSnapshot(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive
);

Paramètres

[in] wszPath

Pointeur vers une chaîne de caractères larges terminée par null contenant le répertoire racine sous lequel les fichiers doivent être exclus.

Le répertoire peut être un répertoire local sur l’ordinateur VSS ou un répertoire de partage de fichiers sur un serveur de fichiers distant.

Les chemins UNC sont pris en charge.

Le chemin d’accès peut contenir des variables d’environnement (par exemple, %SystemRoot%), mais ne peut pas contenir de caractères génériques.

Il n’est pas nécessaire que le chemin se termine par une barre oblique inverse («  »). Il appartient aux applications qui récupèrent ces informations de case activée si le chemin se termine par une barre oblique inverse.

[in] wszFilespec

Pointeur vers une chaîne de caractères larges terminée par null contenant la spécification de fichier des fichiers à exclure.

Une spécification de fichier ne peut pas contenir de spécifications de répertoire (par exemple, aucune barre oblique inverse), mais peut contenir le ? et * caractères génériques.

[in] bRecursive

Valeur booléenne spécifiant si le chemin spécifié par le paramètre wszPath n’identifie qu’un seul répertoire ou s’il indique une hiérarchie de répertoires à parcourir de manière récursive. Ce paramètre doit avoir la valeur true si le chemin d’accès est traité comme une hiérarchie de répertoires à récurrencer, ou false dans le cas contraire.

Pour plus d’informations sur la traversée des dossiers montés, consultez Utilisation des dossiers montés et points d’analyse.

Valeur retournée

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

Valeur Signification
S_OK
0x00000000L
 L'opération a réussi.
E_INVALIDARG
0x80070057L
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
0x8007000EL
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_NOT_SUPPORTED
0x8004232FL
 Cette méthode n’est pas prise en charge pour les rédacteurs express.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP et Windows Server 2003 : Les partages de fichiers distants ne sont pas pris en charge tant qu’Windows 8 et Windows Server 2012.

L’utilisation de la méthode AddExcludeFilesFromSnapshot est facultative. Les enregistreurs doivent utiliser cette méthode uniquement pour les fichiers volumineux qui changent considérablement entre les opérations de cliché instantané.

Cette méthode ne remplace pas la méthode IVssCreateWriterMetadata ::AddExcludeFiles . Les rédacteurs doivent continuer à utiliser la méthode AddExcludeFiles pour indiquer quels jeux de fichiers sont exclus de la sauvegarde.

L’appelant est chargé d’appeler la méthode IUnknown ::Release pour libérer les ressources de l’objet IVssWMFiledesc retourné.

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 vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque VssApi.lib

Voir aussi

IVssCreateWriterMetadata ::AddExcludeFiles

IVssCreateWriterMetadataEx

IVssExamineWriterMetadataEx2 ::GetExcludeFromSnapshotCount

IVssExamineWriterMetadataEx2 ::GetExcludeFromSnapshotFile