CLS_CONTAINER_INFORMATION Struktur (clfs.h)

Beschreibt allgemeine Informationen zu einem Container. Die Funktionen CreateLogContainerScanContext und ScanLogContainers verwenden Containerdeskriptoren, um Informationen zu allen CLFS-Containern (Common Log File System) zu überprüfen und zurückzugeben.

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;

Member

FileAttributes

Die Dateisystemattribute. CLFS verwendet die folgenden Attribute:

• FILE_ATTRIBUTE_ARCHIVE: Das Protokoll ist nicht kurzlebig.
• FILE_ATTRIBUTE_DEDICATED: Das Protokoll wird nicht multiplext.
• FILE_ATTRIBUTE_READONLY: Die Datei ist schreibgeschützt. Anwendungen können die Datei lesen, aber nicht in sie schreiben oder löschen.

CLFS ignoriert, behält aber alle anderen Dateiattributewerte bei. Im Thema SetFileAttributes werden die gültigen Werte für Attribute aufgelistet.

CreationTime

Der Zeitpunkt, zu dem eine Datei erstellt wird.

LastAccessTime

Das letzte Mal, wenn ein Container aus gelesen oder geschrieben wird.

LastWriteTime

Das letzte Mal, in das ein Container geschrieben wird.

ContainerSize

Die Größe eines Containers in Bytes.

FileNameActualLength

Die Größe des tatsächlichen Dateinamens in Zeichen.

Diese Zahl unterscheidet sich von FileNameLength , wenn der Dateiname des Containers länger als MAX_PATH_LENGTH ist.

FileNameLength

Die Größe des Dateinamens im FileName-Puffer in Zeichen.

FileName[CLFS_MAX_CONTAINER_INFO]

Ein Zeiger auf eine Zeichenfolge, die den Dateinamen für einen Container enthält.

State

Der aktuelle Zustand eines Containers.

Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
ClfsContainerInitializing	Der Container wird gerade initialisiert.
ClfsContainerInactive	Der Container ist zugeordnet, befindet sich aber nicht in der aktiven Region des Protokolls.
ClfsContainerActive	Der Container wird als Speicher für einen Teil des Protokolls verwendet.
ClfsContainerActivePendingDelete	Der Container ist zum Löschen markiert, enthält aber weiterhin einen Teil des aktiven Protokolls.
ClfsContainerPendingArchive	Der Container ist für das Archiv markiert.
ClfsContainerPendingArchiveAndDelete	Der Container ist zum Löschen markiert, enthält aber weiterhin Protokolldaten, die nicht archiviert werden.

PhysicalContainerId

Der physische Containerbezeichner, der nicht geändert werden kann.

LogicalContainerId

Der logische Containerbezeichner, der sich jedes Mal ändert, wenn der Container wiederverwendet wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [nur Desktop-Apps]
Kopfzeile	clfs.h (include Clfsw32.h)

Weitere Informationen

CreateLogContainerScanContext

GetLogContainerName

ScanLogContainers