Função função cchksgfiles. PgnoFromFileOffsetCChkSGFiles.PgnoFromFileOffset 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

Retorna o número de página do banco de dados lógico que corresponde ao índice de bytes especificado no arquivo de banco de dados físico.Returns the logical database page number that corresponds to the specified byte index in the physical database file. Se o deslocamento do arquivo for inválido, ou se a função ErrCheckDbHeaders não tiver sido chamada para os bancos de dados, essa função retornará 0 (zero).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. O deslocamento em um arquivo de banco de dados, em bytes.The offset into a database file, in bytes.

Valor de retornoReturn value

O número de página lógica do arquivo de banco de dados que inclui o deslocamento especificado.The database file's logical page number that includes the specified offset.

ComentáriosRemarks

Se o parâmetro ibFileOffset for inválido, a função PgnoFromFileOffset retornará 0 (zero).If the ibFileOffset parameter is invalid, the PgnoFromFileOffset function returns 0 (zero).

PgnoFromFileOffset também retornará 0 (zero) se você não chamou a função ErrCheckDbHeaders na instância do CCheckSGFiles .PgnoFromFileOffset also returns 0 (zero) if you haven't called the ErrCheckDbHeaders function on the CCheckSGFiles instance. Você deve chamar ErrCheckDbHeaders para inicializar o tamanho da página do banco de dados e o número de páginas alocadas para cabeçalhos do banco de dados.You must call ErrCheckDbHeaders to initialize the database page size and number of pages allocated to database headers.

Você deve usar PgnoFromFileOffset para preencher os elementos da estrutura de ** _ informações da página** em preparação para chamar ErrCheckDbPages.You should use PgnoFromFileOffset to fill in the PAGE_INFO structure elements in preparation for calling ErrCheckDbPages. O parâmetro rgPageInfo para ErrCheckDbPages exige que cada elemento na matriz seja uma estrutura PAGE_INFO , com os valores de membro ulPgno inicializados corretamente.The rgPageInfo parameter to ErrCheckDbPages requires that each element in the array be a PAGE_INFO structure, with the ulPgno member values correctly initialized.

Se você estiver usando o CHKSGFILES em um aplicativo multi-threaded, poderá chamar a função PgnoFromFileOffset na parte multithread do aplicativo.If you're using CHKSGFILES in a multithreaded application, you can call the PgnoFromFileOffset function in the multithreaded portion of the application. Observe que você normalmente chamaria essa função várias vezes para cada banco de dados sendo verificado.Note that you would typically call this function multiple times for each database being checked.

RequirementsRequirements

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

A conta sob a qual o aplicativo está sendo executado deve ter permissão 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 permission to the database and log files that are to be checked.