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

  • Article

La méthode AddExcludeFiles est utilisée pour exclure explicitement un jeu de fichiers (un ou plusieurs fichiers spécifiés) qui pourraient sinon être inclus implicitement lorsqu’un composant de l’enregistreur actuel est sauvegardé.

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 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 obligatoire 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

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 que Windows 8 et Windows Server 2012. Les enregistreurs prennent uniquement en charge les ressources locales, c’est-à-dire les ensembles de fichiers dont le chemin 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 donné, 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

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

Voir aussi

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent