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 |