Función CChkSGFiles.ErrCheckDbHeaders

Se aplica a: Exchange Server 2003 | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013

Valida los encabezados de los archivos de base de datos especificados por la función ErrInit . 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.

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

Parameters

pcbDbPageSize

Parámetro de salida. Tamaño de página de cada una de las bases de datos especificadas, en bytes.

pcHeaderPagesPerDb

Parámetro de salida. Número de páginas al principio de cada base de datos especificada reservadas por el motor de base de datos para su uso interno. Tenga en cuenta que no debe pasar páginas de encabezado a la función ErrCheckDbPages para la validación.

piDbErrorEncountered

Parámetro de salida. Si el valor devuelto de la función indica un error, este parámetro será un índice en la matriz rgwszDb[] que se pasa a la función ErrInit . El elemento de matriz indizada representa la base de datos en la que se encontró el error. Si la función no devuelve un valor de error, este valor de parámetro no es válido.

ulFlags

Parámetro de entrada opcional. Este valor está reservado para su uso futuro. El valor pasado debe ser 0 (cero).

Valor devuelto

Esta función devuelve un código de error de la enumeración CChkSGFiles.ERR.

Comentarios

ErrCheckDbHeaders comprueba que todas las bases de datos registradas con ErrInit tienen el mismo tamaño de página de firma de registro y base de datos. También puede usar el valor de parámetro genMin más bajo y el valor de parámetro genMax más alto para determinar el conjunto de archivos de registro necesarios para llevar todas las bases de datos registradas a un estado de cierre limpio.

El parámetro piDbErrorEncountered solo se establece cuando se detecta un error, como indica un valor devuelto de ErrCheckDbHeaders distinto de cero.

Cuando se produce un error en esta función, se agregará un evento de error al registro de eventos error de Windows.

Puede llamar a ErrCheckDbHeaders solo después de llamar a ErrInit y debe llamarlo antes de llamar a ErrCheckDbPages y ErrCheckLogs.

Si usa CHKSGFILES en una aplicación multiproceso, debe llamar a la función ErrCheckDbHeaders en la parte de un solo subproceso y solo puede llamarla una vez para cada objeto CCheckSGFiles .

Requisitos

Exchange 2013 solo incluye una versión de 64 bits de la API CHKSGFILES.

La cuenta en la que se ejecuta la aplicación debe tener permisos de acceso de lectura para la base de datos y los archivos de registro que se van a comprobar.