Função CChkSGFiles.ErrCheckDbHeaders

Aplica-se a: Exchange Server 2003 | Exchange Server 2007 | Exchange Server | 2010 Exchange Server 2013

Valida os cabeçalhos dos arquivos de banco de dados especificados pela função ErrInit . Essa função também retorna o tamanho da página e o número de páginas em cada um dos bancos de dados especificados.

Vitual ERRErrCheckDbHeaders  
(
        ULONG  * const pcbDbPageSize,
        ULONG  * const pcHeaderPagesPerDb,
        ULONG   const piDbErrorEncountered,
    Const ULONGulFlags = NO_FLAGS
);

Parâmetros

pcbDbPageSize

Parâmetro de saída. O tamanho da página de cada um dos bancos de dados especificados, em bytes.

pcHeaderPagesPerDb

Parâmetro de saída. O número de páginas no início de cada banco de dados especificado que são reservadas pelo mecanismo de banco de dados para uso interno. Observe que você não deve passar páginas de cabeçalho para a função ErrCheckDbPages para validação.

piDbErrorEncountered

Parâmetro de saída. Se o valor retornado da função indicar um erro, esse parâmetro será um índice na matriz rgwszDb[] passada para a função ErrInit . O elemento de matriz indexada representa o banco de dados no qual o erro foi encontrado. Se a função não retornar um valor de erro, esse valor de parâmetro será inválido.

ulFlags

Parâmetro de entrada opcional. Esse valor é reservado para uso futuro. O valor passado deve ser 0 (zero).

Valor de retorno

Essa função retorna um código de erro da enumeração CChkSGFiles.ERR.

Comentários

O ErrCheckDbHeaders verifica se todos os bancos de dados registrados com errInit têm o mesmo tamanho da assinatura de log e da página do banco de dados. Você também pode usar o valor de parâmetro genMin mais baixo e o valor de parâmetro genMax mais alto para determinar o conjunto de arquivos de log necessários para levar todos os bancos de dados registrados a um estado de desligamento limpo.

O parâmetro piDbErrorEncountered é definido somente quando um erro é detectado, conforme indicado por um valor de retorno ErrCheckDbHeaders não zero.

Quando ocorrer um erro nessa função, um evento de erro será adicionado ao log de eventos erro do Windows.

Você só pode chamar ErrCheckDbHeaders depois de ligar para o ErrInit e chamá-lo antes de chamar ErrCheckDbPages e ErrCheckLogs.

Se você estiver usando CHKSGFILES em um aplicativo multithreaded, você deve chamar a função ErrCheckDbHeaders na parte de thread único e pode chamá-la apenas uma vez para cada objeto CCheckSGFiles .

Requisitos

O Exchange 2013 inclui apenas uma versão de 64 bits da API CHKSGFILES.

A conta em que o aplicativo está em execução deve ter permissões de acesso de leitura para o banco de dados e arquivos de log que devem ser verificados.