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

Article
08/27/2023

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
S_OK	L'opération a réussi.
E_INVALIDARG	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.
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_OBJECT_NOT_FOUND	Le composant spécifié n’existe pas.
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.

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

Voir aussi

IVssCreateExpressWriterMetadata

Partager via