Export (0) Print
Expand All

CLFS_CONTAINER_INFORMATION structure

Describes general information about a container. The CreateLogContainerScanContext and ScanLogContainers functions use container descriptors to scan and return information about all Common Log File System (CLFS) containers.

Syntax


typedef struct _CLFS_CONTAINER_INFORMATION {
  ULONG                FileAttributes;
  ULONGLONG            CreationTime;
  ULONGLONG            LastAccessTime;
  ULONGLONG            LastWriteTime;
  LONGLONG             ContainerSize;
  ULONG                FileNameActualLength;
  ULONG                FileNameLength;
  WCHAR                FileName[[MAX_PATH]];
  CLFS_CONTAINER_STATE State;
  CLFS_CONTAINER_ID    PhysicalContainerId;
  CLFS_CONTAINER_ID    LogicalContainerId;
} CLFS_CONTAINER_INFORMATION, *PCLFS_CONTAINER_INFORMATION, **PPCLFS_CONTAINER_INFORMATION;

Members

FileAttributes

The file system attributes. CLFS uses the following attributes:

  • FILE_ATTRIBUTE_ARCHIVE - The log is not ephemeral.
  • FILE_ATTRIBUTE_DEDICATED - The log is not multiplexed.
  • FILE_ATTRIBUTE_READONLY - The file is read-only. Applications can read the file, but cannot write to it or delete it.

CLFS ignores but preserves all other file attribute values. The SetFileAttributes topic lists the valid values for attributes.

CreationTime

The time a file is created.

LastAccessTime

The last time a container is read from or written to.

LastWriteTime

The last time a container is written to.

ContainerSize

The size of a container, in bytes.

FileNameActualLength

The size of the actual file name, in characters.

This number is different than FileNameLength when the file name of the container is longer than MAX_PATH_LENGTH.

FileNameLength

The size of the file name in the FileName buffer, in characters.

FileName

A pointer to a string that contains the file name for a container.

State

The current state of a container.

This member can be one of the following values.

ValueMeaning
ClfsContainerInitializing

The container is in the process of initializing.

ClfsContainerInactive

The container is allocated, but is not in the active region of the log.

ClfsContainerActive

The container is being used as storage for part of the log.

ClfsContainerActivePendingDelete

The container is marked for deletion, but still contains part of the active log.

ClfsContainerPendingArchive

The container is marked for archive.

ClfsContainerPendingArchiveAndDelete

The container is marked for deletion, but still contains log data that is not archived.

 

PhysicalContainerId

The physical container identifier that cannot be changed.

LogicalContainerId

The logical container identifier that changes every time the container is recycled.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Clfs.h (include Clfsw32.h)

See also

CreateLogContainerScanContext
GetLogContainerName
ScanLogContainers

 

 

Community Additions

ADD
Show:
© 2014 Microsoft