AddLogContainer, fonction (clfsw32.h)

Ajoute un conteneur au journal physique associé au handle de journal si le processus appelant a un accès en écriture au fichier .blf et la possibilité de créer des fichiers dans le répertoire cible du conteneur.

Cette fonction est différente de AddLogContainerSet, car elle n’ajoute qu’un seul conteneur. Pour ajouter plusieurs conteneurs, il est plus efficace d’utiliser AddLogContainerSet, qui vous permet d’ajouter plusieurs conteneurs. L’ajout de conteneurs permet à un client d’augmenter la taille d’un journal.

Syntaxe

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

Paramètres

[in] hLog

Handle d’un journal ouvert.

Le handle doit être obtenu à partir de CreateLogFile avec un accès en écriture au journal. L’application cliente doit avoir un accès en écriture au fichier .blf et la possibilité de créer des fichiers dans le répertoire cible d’un conteneur.

[in, optional] pcbContainer

Paramètre facultatif qui spécifie la taille du conteneur, en octets.

La taille minimale est de 512 Ko pour les journaux normaux et de 1 024 Ko pour les journaux multiplexés. La taille maximale est d’environ 4 gigaoctets.

Ce paramètre est obligatoire si les conteneurs sont ajoutés à un journal nouvellement créé. Si un conteneur est déjà créé, ce paramètre peut être NULL ou une valeur au moins égale à la taille du premier conteneur.

Les tailles de conteneur de journaux sont des multiples de la taille de la région du journal (512 Ko). Lorsque vous ajoutez un conteneur à un nouveau fichier, la fonction AddLogContainer arrondit la taille du conteneur à la limite de 512 Ko suivante et retourne cette taille dans la valeur pointée par pcbContainer.

De même, si le journal a déjà au moins un conteneur et que la valeur de *pcbContainer est au moins égale à la taille de conteneur actuelle, la fonction crée tous les conteneurs avec la taille interne actuelle et retourne cette taille dans *pcbContainer.

[in] pwszContainerPath

Pointeur vers une chaîne terminée par null qui contient un chemin d’accès valide pour le nouveau conteneur sur un volume de journal.

[in, out, optional] pReserved

Réservé. Définissez pReserved sur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

La liste suivante identifie les codes d’erreur possibles :

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	clfsw32.h
Bibliothèque	Clfsw32.lib
DLL	Clfsw32.dll

Voir aussi

AddLogContainerSet

Fonctions courantes du système de fichiers journaux

CreateLogFile