Méthode IVssCreateExpressWriterMetadata::AddFilesToFileGroup (vswriter.h)
Ajoute un jeu de fichiers (un ou plusieurs fichiers spécifiés) à un composant de groupe de fichiers spécifié pour un enregistreur express.
Syntaxe
HRESULT AddFilesToFileGroup(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszGroupName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive,
[in] LPCWSTR wszAlternateLocation,
[in] DWORD dwBackupTypeMask
);
Paramètres
[in] wszLogicalPath
Pointeur vers une chaîne de caractères larges terminée par null contenant le chemin logique (qui peut être NULL) du composant auquel ajouter les fichiers. Pour plus d’informations, consultez Chemin d’accès logique des composants.
[in] wszGroupName
Pointeur vers une chaîne de caractères larges terminée par null contenant le nom du composant de groupe de fichiers. Le type de ce composant doit être VSS_CT_FILEGROUP ; sinon, la méthode retourne une erreur.
[in] wszPath
Pointeur vers une chaîne de caractères larges terminée par null contenant le répertoire racine par défaut des fichiers à ajouter.
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 à inclure.
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.
[in] wszAlternateLocation
Ce paramètre est réservé et doit avoir la valeur NULL.
[in] dwBackupTypeMask
Masque de bits de VSS_FILE_SPEC_BACKUP_TYPE valeurs d’énumération pour indiquer si un enregistreur doit évaluer la participation du fichier à un certain type d’opérations de sauvegarde.
Ce paramètre ne peut pas inclure VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED ou VSS_FSBT_LOG_BACKUP_REQUIRED.
La valeur par défaut de cet argument est (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
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, ou l’appelant a tenté d’ajouter des fichiers de groupe de fichiers à un composant non-groupe de fichiers. |
|
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. |
|
Le composant spécifié n’existe pas. |
|
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. |
Configuration requise
| 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 |