Méthode IVssCreateWriterMetadataEx ::AddExcludeFilesFromSnapshot (vswriter.h)
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 |
|---|---|
|
L'opération a réussi. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a plus de mémoire ou d’autres ressources système. |
|
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. |
|
Cette méthode n’est pas prise en charge pour les rédacteurs express. |
|
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