Fonction SetLogFileSizeWithPolicy (clfsmgmtw32.h)

  • Article

Ajoute ou supprime des conteneurs d’un journal en fonction de l’état des stratégies installées.

Syntaxe

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

Paramètres

[in] hLog

Handle d’un journal.

[in] pDesiredSize

Pointeur vers une valeur qui spécifie la taille de journal demandée, exprimée sous la forme d’une des valeurs suivantes. Pour connaître la taille réelle résultante, reportez-vous au paramètre pResultingSize .

Valeur Signification
0
 Appliquez la stratégie de taille minimale.

Si aucune stratégie de taille minimale n’est installée, l’une des opérations suivantes se produit :

  • Si le journal a moins de deux conteneurs, le journal est développé à une taille de deux conteneurs.
  • Si le journal comporte au moins deux conteneurs, aucune modification n’est apportée et l’appel de fonction réussit.

Si une stratégie de taille minimale est installée, l’une des opérations suivantes se produit :

  • Si le journal a moins de conteneurs que le nombre minimal de conteneurs spécifié par la stratégie de taille minimale, le journal s’étend au nombre minimal de conteneurs spécifié par la stratégie.
  • Si le journal a un nombre de conteneurs supérieur ou égal au nombre minimal de conteneurs spécifié par la stratégie de taille minimale, aucune modification n’est apportée et l’appel de fonction réussit sans erreur.

Pour plus d’informations, consultez InstallLogPolicy.
1
 Valeur non valide ; l’appel de fonction échoue avec ERROR_INVALID_PARAMETER.
2–1023
 Taille souhaitée du journal, exprimée en tant que nombre de conteneurs.

Si ce nombre est inférieur au nombre minimal de conteneurs spécifié par la stratégie installée, l’appel de fonction échoue avec ERROR_COULD_NOT_RESIZE_LOG.

Si ce nombre est supérieur au nombre maximal de conteneurs spécifié par la stratégie installée, le journal se développe uniquement en ce qui concerne le nombre maximal de conteneurs spécifié par la stratégie, et la fonction réussit sans erreur.
1024–MAXULONGLONG
 Si aucune stratégie de taille maximale n’est installée, l’appel de fonction échoue avec ERROR_LOG_POLICY_CONFLICT.

Si une stratégie de taille maximale est installée, le journal s’étend au nombre maximal de conteneurs spécifié par la stratégie de taille maximale et la fonction réussit sans erreur.

[out] pResultingSize

Un pointeur vers une variable de données ULONGLONG valide reçoit le nombre de conteneurs dans le journal redimensionné en cas de réussite.

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 la fonction GetLastError.

Notes

Les conteneurs sont créés à l’aide des mêmes attributs de sécurité que le fichier .blf et sont créés dans le contexte de l’application, et non dans le contexte du propriétaire du fichier .blf. Pour plus d’informations sur les fichiers .blf, consultez Types de journaux. Si des conteneurs sont supprimés, ils sont supprimés à l’aide du contexte de sécurité de l’application appelante.

Exemples

Pour obtenir un exemple qui utilise cette fonction, consultez Création d’un fichier journal.

Spécifications

   
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 clfsmgmtw32.h
Bibliothèque Clfsw32.lib
DLL Clfsw32.dll

Voir aussi

Création d’un fichier journal

InstallLogPolicy

Types de journaux