Función función cchksgfiles. ErrCheckDbHeadersCChkSGFiles.ErrCheckDbHeaders function

Se aplica 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 los encabezados de los archivos de base de datos que especificó la función ErrInit .Validates the headers of the database files that were specified by the ErrInit function. Esta función también devuelve el tamaño de página y el número de páginas de cada una de las bases de datos especificadas.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 salida.Output parameter. El tamaño de página de cada una de las bases de datos especificadas, en bytes.The page size of each of the specified databases, in bytes.

pcHeaderPagesPerDbpcHeaderPagesPerDb

Parámetro de salida.Output parameter. Número de páginas al principio de cada base de datos especificada que están reservadas por el motor de base de datos para uso interno.The number of pages at the beginning of each specified database that are reserved by the database engine for internal use. Tenga en cuenta que no debe pasar páginas de encabezado a la función ErrCheckDbPages para la validación.Note that you should not pass header pages to the ErrCheckDbPages function for validation.

piDbErrorEncounteredpiDbErrorEncountered

Parámetro de salida.Output parameter. Si el valor devuelto de la función indica un error, este parámetro será un índice en la matriz rgwszDb [] pasada a la función 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. El elemento de matriz indizada representa la base de datos en la que se encontró el error.The indexed array element represents the database in which the error was encountered. Si la función no devuelve un valor de error, este valor de parámetro no es válido.If the function does not return an error value, this parameter value is invalid.

ulFlagsulFlags

Parámetro de entrada opcional.Optional input parameter. Este valor se reserva para uso futuro.This value is reserved for future use. El valor pasado debe ser 0 (cero).The value passed should be 0 (zero).

Valor devueltoReturn value

Esta función devuelve un código de error de la enumeración función cchksgfiles. err.This function returns an error code from the CChkSGFiles.ERR enumeration.

ComentariosRemarks

ErrCheckDbHeaders comprueba que todas las bases de datos registradas con ErrInit tienen la misma firma de registro y tamaño de página de la base de datos.ErrCheckDbHeaders verifies that all databases registered with ErrInit have the same log signature and database page size. También puede usar el valor del parámetro genMin más bajo y el valor del parámetro más alto genMax para determinar el conjunto de archivos de registro que son necesarios para poner todas las bases de datos registradas en un estado de cierre limpio.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.

El parámetro piDbErrorEncountered se establece únicamente cuando se detecta un error, tal como lo indica un valor devuelto distinto de cero ErrCheckDbHeaders .The piDbErrorEncountered parameter is set only when an error is detected, as indicated by a non-zero ErrCheckDbHeaders return value.

Cuando se produce un error en esta función, se agrega un evento de error al registro de eventos de error de Windows.When an error occurs in this function, an error event will be added to the Windows Error event log.

Puede llamar a ErrCheckDbHeaders solo después de llamar a ErrInity debe llamarlo antes de llamar a ErrCheckDbPages y ErrCheckLogs.You can call ErrCheckDbHeaders only after calling ErrInit, and you must call it before calling ErrCheckDbPages and ErrCheckLogs.

Si está usando CHKSGFILES en una aplicación multiproceso, debe llamar a la función ErrCheckDbHeaders en la parte de subproceso único y puede llamarla solo una 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

Exchange 2013 solo incluye una versión de 64 bits de la API CHKSGFILES.Exchange 2013 only includes a 64-bit version of the CHKSGFILES API.

La cuenta en la que se ejecuta la aplicación debe tener permisos de acceso de lectura a los archivos de base de datos y de registro que se van a comprobar.The account that the application is running under must have read access permissions to the database and log files that are to be checked.