Función CChkSGFiles.PgnoFromFileOffset

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

Devuelve el número de página de la base de datos lógica que corresponde al índice de bytes especificado en el archivo de base de datos física. Si el desplazamiento del archivo no es válido o si no se ha llamado a la función ErrCheckDbHeaders para las bases de datos, esta función devuelve 0 (cero).

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

Parameters

ibFileOffset

Parámetro de entrada. Desplazamiento en un archivo de base de datos, en bytes.

Valor devuelto

Número de página lógica del archivo de base de datos que incluye el desplazamiento especificado.

Comentarios

Si el parámetro ibFileOffset no es válido, la función PgnoFromFileOffset devuelve 0 (cero).

PgnoFromFileOffset también devuelve 0 (cero) si no ha llamado a la función ErrCheckDbHeaders en la instancia de CCheckSGFiles . Debe llamar a ErrCheckDbHeaders para inicializar el tamaño de página de la base de datos y el número de páginas asignadas a los encabezados de base de datos.

Debe usar PgnoFromFileOffset para rellenar los elementos de la estructura PAGE_INFO como preparación para llamar a ErrCheckDbPages. El parámetro rgPageInfo de ErrCheckDbPages requiere que cada elemento de la matriz sea una estructura PAGE_INFO , con los valores de miembro ulPgno inicializados correctamente.

Si usa CHKSGFILES en una aplicación multiproceso, puede llamar a la función PgnoFromFileOffset en la parte multiproceso de la aplicación. Tenga en cuenta que normalmente llamaría a esta función varias veces para cada base de datos que se comprueba.

Requisitos

Exchange Server 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 permiso de lectura para la base de datos y los archivos de registro que se van a comprobar.