Função função cchksgfiles. ErrCheckDbHeadersCChkSGFiles.ErrCheckDbHeaders function

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

Valida os cabeçalhos dos arquivos de banco de dados que foram especificados pela função ErrInit .Validates the headers of the database files that were specified by the ErrInit function. 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.This function also returns the page size and number of pages in each of the specified databases.

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

ParâmetrosParameters

pcbDbPageSizepcbDbPageSize

Parâmetro de saída.Output parameter. O tamanho de página de cada um dos bancos de dados especificados, em bytes.The page size of each of the specified databases, in bytes.

pcHeaderPagesPerDbpcHeaderPagesPerDb

Parâmetro de saída.Output parameter. O número de páginas no início de cada banco de dados especificado que são reservados pelo mecanismo de banco de dados para uso interno.The number of pages at the beginning of each specified database that are reserved by the database engine for internal use. Observe que você não deve passar páginas de cabeçalho para a função ErrCheckDbPages para validação.Note that you should not pass header pages to the ErrCheckDbPages function for validation.

piDbErrorEncounteredpiDbErrorEncountered

Parâmetro de saída.Output parameter. Se o valor de retorno da função indicar um erro, esse parâmetro será um índice na matriz rgwszDb [] passada para a função ErrInit .If the return value of the function indicates an error, this parameter will be an index into the rgwszDb[] array passed to the ErrInit function. O elemento de matriz indexada representa o banco de dados no qual o erro foi encontrado.The indexed array element represents the database in which the error was encountered. Se a função não retornar um valor de erro, esse valor de parâmetro é inválido.If the function does not return an error value, this parameter value is invalid.

ulFlagsulFlags

Parâmetro de entrada opcional.Optional input parameter. Esse valor é reservado para uso futuro.This value is reserved for future use. O valor passado deve ser 0 (zero).The value passed should be 0 (zero).

Valor de retornoReturn value

Essa função retorna um código de erro da Enumeração função cchksgfiles. err.This function returns an error code from the CChkSGFiles.ERR enumeration.

ComentáriosRemarks

ErrCheckDbHeaders verifica se todos os bancos de dados registrados com ErrInit têm a mesma assinatura de log e o tamanho da página do banco de dados.ErrCheckDbHeaders verifies that all databases registered with ErrInit have the same log signature and database page size. Você também pode usar o menor valor de parâmetro genMin e o valor de parâmetro de genMax mais alto para determinar o conjunto de arquivos de log que são necessários para colocar todos os bancos de dados registrados em um estado de desligamento normal.You can also use the lowest genMin parameter value and the highest genMax parameter value to determine the set of log files that are necessary to bring all of the registered databases to a clean-shutdown state.

O parâmetro piDbErrorEncountered é definido somente quando um erro é detectado, conforme indicado por um valor de retorno diferente de zero ErrCheckDbHeaders .The piDbErrorEncountered parameter is set only when an error is detected, as indicated by a non-zero ErrCheckDbHeaders return value.

Quando ocorrer um erro nesta função, um evento de erro será adicionado ao log de eventos de erro do Windows.When an error occurs in this function, an error event will be added to the Windows Error event log.

Você pode chamar ErrCheckDbHeaders somente depois de chamar ErrInite deve chamá-lo antes de chamar ErrCheckDbPages e ErrCheckLogs.You can call ErrCheckDbHeaders only after calling ErrInit, and you must call it before calling ErrCheckDbPages and ErrCheckLogs.

Se você estiver usando o CHKSGFILES em um aplicativo multi-threaded, deverá chamar a função ErrCheckDbHeaders na parte de thread único e você poderá chamá-la apenas uma vez para cada objeto CCheckSGFiles .If you're using CHKSGFILES in a multithreaded application, you must call the ErrCheckDbHeaders function in the single-threaded portion, and you can call it only once for each CCheckSGFiles object.

RequirementsRequirements

O Exchange 2013 inclui apenas uma versão de 64 bits da API CHKSGFILES.Exchange 2013 only includes a 64-bit version of the CHKSGFILES API.

A conta sob a qual o aplicativo está sendo executado deve ter permissões de acesso de leitura para o banco de dados e arquivos de log que devem ser verificados.The account that the application is running under must have read access permissions to the database and log files that are to be checked.