Función función cchksgfiles. PgnoFromFileOffsetCChkSGFiles.PgnoFromFileOffset 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

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ísico.Returns the logical database page number that corresponds to the specified byte index in the physical database file. Si el desplazamiento de 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).If the file offset is invalid, or if the ErrCheckDbHeaders function has not been called for the databases, this function returns 0 (zero).

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

ParámetrosParameters

ibFileOffsetibFileOffset

Parámetro de entrada.Input parameter. El desplazamiento en un archivo de base de datos, en bytes.The offset into a database file, in bytes.

Valor devueltoReturn value

Número de página lógica del archivo de base de datos que incluye el desplazamiento especificado.The database file's logical page number that includes the specified offset.

ComentariosRemarks

Si el parámetro ibFileOffset no es válido, la función PgnoFromFileOffset devuelve 0 (cero).If the ibFileOffset parameter is invalid, the PgnoFromFileOffset function returns 0 (zero).

PgnoFromFileOffset también devuelve 0 (cero) si no ha llamado a la función ErrCheckDbHeaders en la instancia de CCheckSGFiles .PgnoFromFileOffset also returns 0 (zero) if you haven't called the ErrCheckDbHeaders function on the CCheckSGFiles instance. 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 la base de datos.You must call ErrCheckDbHeaders to initialize the database page size and number of pages allocated to database headers.

Debe usar PgnoFromFileOffset para rellenar los elementos de la estructura de ** _ información de página** en preparación para llamar a ErrCheckDbPages.You should use PgnoFromFileOffset to fill in the PAGE_INFO structure elements in preparation for calling ErrCheckDbPages. El parámetro rgPageInfo para ErrCheckDbPages requiere que cada elemento de la matriz sea una estructura PAGE_INFO , con los valores de los miembros ulPgno inicializados correctamente.The rgPageInfo parameter to ErrCheckDbPages requires that each element in the array be a PAGE_INFO structure, with the ulPgno member values correctly initialized.

Si está usando CHKSGFILES en una aplicación multiproceso, puede llamar a la función PgnoFromFileOffset en la parte multiproceso de la aplicación.If you're using CHKSGFILES in a multithreaded application, you can call the PgnoFromFileOffset function in the multithreaded portion of the application. Tenga en cuenta que normalmente llamaría esta función varias veces para cada base de datos que se está comprobando.Note that you would typically call this function multiple times for each database being checked.

RequirementsRequirements

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

La cuenta con la que se ejecuta la aplicación debe tener permiso de lectura en 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 permission to the database and log files that are to be checked.