CLS_CONTAINER_INFORMATION structure (wdm.h)
The CLFS_CONTAINER_INFORMATION structure holds descriptive information for an individual container in a Common Log File System (CLFS) log.
Syntax
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;
Members
FileAttributes
A set of flags that specifies attributes of the container. See the fFlagsAndAttributes parameter of the ClfsCreateLogFile function.
CreationTime
The time that the container was created.
LastAccessTime
The time that the container was last accessed.
LastWriteTime
The time of the last write to the container.
ContainerSize
The size, in bytes, of the container.
FileNameActualLength
The size, in characters, of the actual file name of the container.
FileNameLength
The size of the file name in the FileName buffer.
FileName[CLFS_MAX_CONTAINER_INFO]
An array of wide characters that holds the file name of the container.
State
An integer that specifies the state of the container. This member must be one of the following values.
| Value | Meaning |
|---|---|
| ClfsContainerInitializing | The container has not yet been initialized. |
| ClfsContainerInactive | The container has been initialized but does not hold any records that are in the active portion of the log. |
| ClfsContainerActive | The container is being used to hold records that belong to the active portion of the log. |
| ClfsContainerActivePendingDelete | The container is marked for deletion, but still holds records that belong to the active portion of the log. |
| ClfsContainerPendingArchive | The container is pending archival. |
| ClfsContainerPendingArchiveAndDelete | The container is marked for deletion, but still contains records that are pending archival. |
PhysicalContainerId
A 32-bit identifier that remains the same over the life of the log.
LogicalContainerId
A 32-bit identifier that changes every time the container is recycled.
Remarks
The ClfsScanLogContainers function writes descriptive information into an array of CLFS_CONTAINER_INFORMATION structures.
Time values CreationTime, LastAccessTime, and LastWriteTime are expressed in absolute system time format. Absolute system time is the number of 100-nanosecond intervals since the start of the year 1601 in the Gregorian calendar.
Requirements
| Requirement | Value |
|---|---|
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |