Méthode IVssCreateExpressWriterMetadata ::AddExcludeFiles (vswriter.h)

Exclut un jeu de fichiers (un ou plusieurs fichiers spécifiés) qui pourraient être implicitement inclus lors de la sauvegarde d’un composant d’un enregistreur express.

Syntaxe

HRESULT AddExcludeFiles(
  [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 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.

[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 d’accès 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 répare des points.

Valeur retournée

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

Valeur	Signification
S_OK	L'opération a réussi.
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_INVALID_XML_DOCUMENT	Le document XML n’est pas valide. Consultez le journal des événements pour plus d’informations. 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

Les enregistreurs Express prennent uniquement en charge les ressources locales, c’est-à-dire les ensembles de fichiers dont le chemin d’accès absolu commence par une spécification de volume local valide et ne peuvent pas être un lecteur réseau mappé. Par conséquent, les entrées de chemin d’accès (wszPath) à AddExcludeFiles (après la résolution de toutes les variables d’environnement) doivent être dans ce format. Par exemple, il est souvent pratique de définir un composant pour inclure tous les fichiers dans un répertoire spécifié, puis d’utiliser AddExcludeFiles pour supprimer explicitement certains fichiers (pour les fichiers temporaires instance) d’une sauvegarde.

Pour plus d’informations sur l’exclusion de fichiers, consultez Exclure la spécification de liste de fichiers.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

IVssCreateExpressWriterMetadata

IVssCreateExpressWriterMetadata ::AddComponent