estrutura CLS_CONTAINER_INFORMATION (clfs.h)

Descreve informações gerais sobre um contêiner. As funções CreateLogContainerScanContext e ScanLogContainers usam descritores de contêiner para verificar e retornar informações sobre todos os contêineres do CLFS (Common Log File System).

Sintaxe

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;

Membros

FileAttributes

Os atributos do sistema de arquivos. O CLFS usa os seguintes atributos:

  • FILE_ATTRIBUTE_ARCHIVE – o log não é efêmero.
  • FILE_ATTRIBUTE_DEDICATED – o log não é multiplexado.
  • FILE_ATTRIBUTE_READONLY – o arquivo é somente leitura. Os aplicativos podem ler o arquivo, mas não podem gravar nele nem excluí-lo.
O CLFS ignora, mas preserva todos os outros valores de atributo de arquivo. O tópico SetFileAttributes lista os valores válidos para atributos.

CreationTime

A hora em que um arquivo é criado.

LastAccessTime

A última vez em que um contêiner é lido ou gravado.

LastWriteTime

A última vez em que um contêiner é gravado.

ContainerSize

O tamanho de um contêiner, em bytes.

FileNameActualLength

O tamanho do nome do arquivo real, em caracteres.

Esse número é diferente de FileNameLength quando o nome do arquivo do contêiner é maior que MAX_PATH_LENGTH.

FileNameLength

O tamanho do nome do arquivo no buffer FileName , em caracteres.

FileName[CLFS_MAX_CONTAINER_INFO]

Um ponteiro para uma cadeia de caracteres que contém o nome do arquivo de um contêiner.

State

O estado atual de um contêiner.

Esse membro pode ser um dos valores a seguir.

Valor Significado
ClfsContainerInitializing
O contêiner está em processo de inicialização.
ClfsContainerInactive
O contêiner é alocado, mas não está na região ativa do log.
ClfsContainerActive
O contêiner está sendo usado como armazenamento para parte do log.
ClfsContainerActivePendingDelete
O contêiner está marcado para exclusão, mas ainda contém parte do log ativo.
ClfsContainerPendingArchive
O contêiner está marcado para arquivo morto.
ClfsContainerPendingArchiveAndDelete
O contêiner está marcado para exclusão, mas ainda contém dados de log que não estão arquivados.

PhysicalContainerId

O identificador de contêiner físico que não pode ser alterado.

LogicalContainerId

O identificador de contêiner lógico que muda sempre que o contêiner é reciclado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Cabeçalho clfs.h (inclua Clfsw32.h)

Confira também

CreateLogContainerScanContext

GetLogContainerName

ScanLogContainers