通过

CChkSGFiles.PgnoFromFileOffset 函数

  • 项目

适用于：Exchange Server 2003 |Exchange Server 2007 |Exchange Server 2010 |2013 Exchange Server

返回与物理数据库文件中指定字节索引对应的逻辑数据库页码。 如果文件偏移量无效，或者尚未为数据库调用 ErrCheckDbHeaders 函数，则此函数将返回 0 (零) 。

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

参数

ibFileOffset

输入参数。 数据库文件中的偏移量（以字节为单位）。

返回值

包含指定偏移量的数据库文件的逻辑页码。

备注

如果 ibFileOffset 参数无效， 则 PgnoFromFileOffset 函数返回 0 (零) 。

如果尚未在 CCheckSGFiles 实例上调用 ErrCheckDbHeaders 函数，则 PgnoFromFileOffset 还会返回 0 (零) 。 必须调用 ErrCheckDbHeaders 来初始化数据库页大小和分配给数据库标头的页数。

应使用 PgnoFromFileOffset 填充 PAGE_INFO 结构元素，以便为调用 ErrCheckDbPages 做准备。 ErrCheckDbPages 的 rgPageInfo 参数要求数组中的每个元素都是一个PAGE_INFO结构，并正确初始化 ulPgno 成员值。

如果在多线程应用程序中使用 CHKSGFILES，则可以在应用程序的多线程部分调用 PgnoFromFileOffset 函数。 请注意，通常会针对要检查的每个数据库多次调用此函数。

要求

Exchange Server 2013 仅包含 64 位版本的 CHKSGFILES API。

运行应用程序的帐户必须对要检查的数据库和日志文件具有读取权限。