Estrutura JET_LOGINFO

Aplica-se a: Windows | Windows Server

Estrutura JET_LOGINFO

A estrutura JET_LOGINFO retorna informações estruturadas sobre o conjunto de arquivos de log de transações que devem fazer parte de um conjunto de arquivos de backup. A estrutura JET_LOGINFO é o conjunto mínimo de informações necessárias para representar um intervalo de logs recuperados com JetGetLogInfoInstance2 ou especificado para uma recuperação rígida com JetExternalRestore2.

typedef struct {
  unsigned long cbSize;
  unsigned long ulGenLow;
  unsigned long ulGenHigh;
  tchar szBaseName[JET_BASE_NAME_LENGTH + 1];
} JET_LOGINFO;

Membros

cbSize

O tamanho da estrutura em bytes.

Esse membro permite a expansão futura dessa estrutura enquanto habilita a compatibilidade com versões anteriores. Ele sempre deve ser definido como sizeof( JET_LOGINFO ).

ulGenLow

O número de arquivo de log mais baixo (ou mais antigo) que é restaurado. A fidelidade total de um longo sem sinal deve ser preservada, mas nas versões atuais do mecanismo esse número é um número hexadecimal no intervalo de 0x00000 a 0xFFFFF. Isso pode mudar em versões futuras.

ulGenHigh

O número de arquivo de log mais alto (ou mais recente) que é restaurado. A fidelidade total de um longo sem sinal deve ser preservada, mas nas versões atuais do mecanismo esse número é um número hexadecimal no intervalo de 0x00000 a 0xFFFFF. Isso pode mudar em versões futuras.

szBaseName

O prefixo usado para nomear os arquivos de log de transações.

O valor retornado nesse membro é sempre igual à configuração de JET_paramBaseName para a instância que gerou essas informações.

Comentários

Os arquivos de log de transações são nomeados de acordo com o nome base da instância e o número de geração do arquivo de log. O nome é do formato BBBXXXXX. LOG. O BBB corresponde ao nome base do arquivo de log e tem sempre três caracteres de comprimento. XXXXX corresponde ao número de geração do arquivo de log em zero hexadecimal preenchido e tem sempre cinco caracteres de comprimento. LOG é a extensão de arquivo que sempre é fornecida aos arquivos de log de transações pelo mecanismo.

O uso dessas informações estruturadas não é recomendado porque faz com que o aplicativo tenha conhecimento íntimo desse esquema de nomenclatura para arquivos de log de transações. Se o esquema de nomenclatura for alterado no futuro, esse aplicativo não funcionará mais corretamente. É concebível que o formato de log seja alterado para incorporar oito dígitos hexadecimais no futuro. Em vez disso, os aplicativos devem usar a lista explícita de nomes de arquivo retornados por JetGetLogInfo .

Requisitos

Requisito	Valor
Cliente	Requer o Windows Vista ou o Windows XP.
Servidor	Requer o Windows Server 2008 ou o Windows Server 2003.
Cabeçalho	Declarado em Esent.h.
Unicode	Implementado como JET_LOGINFO_W (Unicode) e ANSI (JET_LOGINFO_A ).

Consulte Também

JetExternalRestore2
JetGetLogInfo
JetGetLogInfoInstance2
Parâmetros do sistema