Função CChkSGFiles.PgnoFromFileOffset

Aplica-se a: Exchange Server 2003 | Exchange Server 2007 | Exchange Server | 2010 Exchange Server 2013

Retorna o número da página do banco de dados lógico que corresponde ao índice de bytes especificado no arquivo de banco de dados físico. Se o deslocamento de 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).

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

Parâmetros

ibFileOffset

Parâmetro de entrada. O deslocamento para um arquivo de banco de dados, em bytes.

Valor de retorno

O número de página lógica do arquivo de banco de dados que inclui o deslocamento especificado.

Comentários

Se o parâmetro ibFileOffset for inválido, a função PgnoFromFileOffset retornará 0 (zero).

PgnoFromFileOffset também retornará 0 (zero) se você não tiver chamado a função ErrCheckDbHeaders na instância CCheckSGFiles . Você deve chamar ErrCheckDbHeaders para inicializar o tamanho da página do banco de dados e o número de páginas alocadas em cabeçalhos de banco de dados.

Você deve usar PgnoFromFileOffset para preencher os elementos da estrutura PAGE_INFO em preparação para chamar ErrCheckDbPages. O parâmetro rgPageInfo para ErrCheckDbPages exige que cada elemento na matriz seja uma estrutura PAGE_INFO , com os valores de membro ulPgno corretamente inicializados.

Se você estiver usando CHKSGFILES em um aplicativo multithread, poderá chamar a função PgnoFromFileOffset na parte multithread do aplicativo. Observe que você normalmente chama essa função várias vezes para cada banco de dados que está sendo verificado.

Requisitos

Exchange Server 2013 inclui apenas uma versão de 64 bits da API CHKSGFILES.

A conta em que o aplicativo está em execução deve ter permissão de leitura para o banco de dados e arquivos de log que devem ser verificados.