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

Article
08/27/2023

La méthode AddDatabaseLogFiles indique les fichiers journaux associés à une base de données à sauvegarder, ainsi que leur emplacement.

Syntaxe

HRESULT AddDatabaseLogFiles(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszDatabaseName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] DWORD   dwBackupTypeMask
);

Paramètres

[in] wszLogicalPath

Pointeur vers une chaîne de caractères larges terminée par null contenant le chemin logique du composant de base de données auquel les fichiers journaux seront ajoutés.

Pour plus d’informations, consultez Chemin d’accès logique des composants.

Un chemin logique n’est pas nécessaire et peut être NULL.

[in] wszDatabaseName

Pointeur vers une chaîne de caractères larges terminée par un caractère null contenant le nom du composant de base de données associé aux fichiers journaux. Le type de ce composant doit être VSS_CT_DATABASE ; sinon, la méthode retourne une erreur.

[in] wszPath

Pointeur vers une chaîne de caractères larges terminée par un caractère null contenant le chemin du répertoire contenant les fichiers journaux.

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.

[in] wszFilespec

Pointeur vers une chaîne de caractères larges terminée par un caractère null contenant la spécification de fichier des fichiers journaux associés à la base de données.

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] dwBackupTypeMask

Un masque de bits (ou OR au niveau du bit) de VSS_FILE_SPEC_BACKUP_TYPE valeurs d’énumération pour indiquer si un enregistreur doit évaluer le fichier pour la participation à un certain type d’opérations de sauvegarde.

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 base de données à un composant non de base de données.
E_OUTOFMEMORY	L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT	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.
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.

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: ensembles de fichiers dont le chemin absolu commence par une spécification de volume local valide et ne peut pas être un lecteur réseau mappé. Par conséquent, les entrées de chemin d’accès (wszPath) à AddDatabaseLogFiles (après la résolution de toutes les variables d’environnement) doivent être dans ce format.

Cette méthode peut être appelée plusieurs fois pour un composant de base de données particulier, ce qui peut être nécessaire lorsque plusieurs fichiers journaux sont stockés sur des volumes distincts.

Les valeurs des paramètres wszLogicalPath et wszDatabaseName doivent correspondre à celles de l’un des composants de base de données précédemment ajoutés avec la méthode IVssCreateWriterMetadata::AddComponent .

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

Share via