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 |
|---|---|
|
L'opération a réussi. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
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. |
|
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 |