AddLogContainer, fonction (clfsw32.h)

Ajoute un conteneur au journal physique associé au handle de journal : si le processus appelant a 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 ajoute un seul conteneur. Pour ajouter plusieurs conteneurs, il est plus efficace d’utiliser AddLogContainerSet, ce 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 1024 Ko pour les journaux multiplexés. La taille maximale est d’environ 4 gigaoctets.

Ce paramètre est requis 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 qui est au moins aussi grande que 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 jusqu’à la limite de 512 Ko suivante, puis retourne cette taille dans la valeur pointée par dockerContainer.

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

[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’erreur étendues, appelez GetLastError.

La liste suivante identifie les codes d’erreur possibles :

Spécifications

Voir aussi

AddLogContainerSet

Fonctions courantes du système de fichiers journaux

CreateLogFile