CLS_CONTAINER_INFORMATION structure (clfs.h)

  • Article

Décrit des informations générales sur un conteneur. Les fonctions CreateLogContainerScanContext et ScanLogContainers utilisent des descripteurs de conteneur pour analyser et retourner des informations sur tous les conteneurs CLFS (Common Log File System).

Syntaxe

typedef struct _CLS_CONTAINER_INFORMATION {
  ULONG                FileAttributes;
  ULONGLONG            CreationTime;
  ULONGLONG            LastAccessTime;
  ULONGLONG            LastWriteTime;
  LONGLONG             ContainerSize;
  ULONG                FileNameActualLength;
  ULONG                FileNameLength;
  WCHAR                FileName[CLFS_MAX_CONTAINER_INFO];
  CLFS_CONTAINER_STATE State;
  CLFS_CONTAINER_ID    PhysicalContainerId;
  CLFS_CONTAINER_ID    LogicalContainerId;
} CLS_CONTAINER_INFORMATION, *PCLS_CONTAINER_INFORMATION, PPCLS_CONTAINER_INFORMATION;

Membres

FileAttributes

Attributs du système de fichiers. CLFS utilise les attributs suivants :

  • FILE_ATTRIBUTE_ARCHIVE : le journal n’est pas éphémère.
  • FILE_ATTRIBUTE_DEDICATED : le journal n’est pas multiplexé.
  • FILE_ATTRIBUTE_READONLY : le fichier est en lecture seule. Les applications peuvent lire le fichier, mais elles ne peuvent pas y écrire ni le supprimer.
CLFS ignore mais conserve toutes les autres valeurs d’attribut de fichier. La rubrique SetFileAttributes répertorie les valeurs valides pour les attributs.

CreationTime

Heure de création d’un fichier.

LastAccessTime

Date de la dernière lecture ou écriture d’un conteneur.

LastWriteTime

Date de la dernière écriture d’un conteneur.

ContainerSize

Taille d’un conteneur, en octets.

FileNameActualLength

Taille du nom de fichier réel, en caractères.

Ce nombre est différent de FileNameLength lorsque le nom de fichier du conteneur est plus long que MAX_PATH_LENGTH.

FileNameLength

Taille du nom de fichier dans la mémoire tampon FileName , en caractères.

FileName[CLFS_MAX_CONTAINER_INFO]

Pointeur vers une chaîne qui contient le nom de fichier d’un conteneur.

State

État actuel d’un conteneur.

Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
ClfsContainerInitializing
 Le conteneur est en cours d’initialisation.
ClfsContainerInactive
 Le conteneur est alloué, mais n’est pas dans la région active du journal.
ClfsContainerActive
 Le conteneur est utilisé comme stockage pour une partie du journal.
ClfsContainerActivePendingDelete
 Le conteneur est marqué pour suppression, mais contient toujours une partie du journal actif.
ClfsContainerPendingArchive
 Le conteneur est marqué pour archive.
ClfsContainerPendingArchiveAndDelete
 Le conteneur est marqué pour suppression, mais contient toujours des données de journal qui ne sont pas archivées.

PhysicalContainerId

Identificateur de conteneur physique qui ne peut pas être modifié.

LogicalContainerId

Identificateur de conteneur logique qui change chaque fois que le conteneur est recyclé.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 R2 [applications de bureau uniquement]
En-tête clfs.h (inclure Clfsw32.h)

Voir aussi

CreateLogContainerScanContext

GetLogContainerName

ScanLogContainers