CChkSGFiles.PAGE_INFO 構造体

[アーティクル]
04/04/2023

適用対象: Exchange Server 2003 |Exchange Server 2007 |Exchange Server 2010 |Exchange Server 2013

Exchange データベースページに関する情報を保持します。この構造体は、ErrCheckDbPages 関数で使用されます。

Struct PAGE_INFO  
{
        ULONGulPgno;
        BOOLfPageIsInitialized : 1;
        BOOLfCorrectableError : 1;
        ULONGLONGchecksumActual;
        ULONGLONGchecksumExpected;
        ULONGLONGdbTime;
        ULONGLONGchecksumPageStructure;
        ULONGLONGulFlags;
}

メンバー

ulPgNo

Unsigned Long。確認するデータベースページの論理ページ番号。この値は、ErrCheckDbPages を呼び出す前に設定しておく必要があります。アプリケーションがファイルのオフセットに基づいてファイルを読み取る場合は、該当するファイルのオフセットを論理ページ番号にマップする必要がありますが、PgnoFromFileOffset メソッドは、このフィールドの値の決定に役立ちます。 ErrCheckDbPages は、この値を変更しません。

fPageIsInitialized

ブール。 TRUE の値は、データベースページにデータが含まれていることを表します。 FALSE の値は、ページにゼロのみが含まれていることを表します。 ErrCheckDbPages は、この値を設定します。

fCorrectableError

ブール。 TRUE の値は、データベースページに修正可能なチェックサムの不一致が検出されたことを表します。 ErrCheckDbPages は、この値を設定します。

checksumActual

64 ビット符号なし整数。この論理ページのデータベースに格納されているチェックサム値を表します。 ErrCheckDbPages は、この値を設定します。

checksumExpected

64 ビット符号なし整数。これは、データベースページに対して計算される予想されるチェックサム値です。 ErrCheckDbPages によって設定されます。この値がデータベースページに格納されている値 (つまり checksumActual で返される値) と異なる場合、 ErrCheckDbPages はこのデータベースページでエラーが見つかったことを示します。

dbTime

64 ビット符号なし整数。 ErrCheckDbPages は、このメンバーをデータベースページのタイムスタンプに設定します。

checksumPageStructure

符号なし 64-bt 整数。 ErrCheckDbPages は、 論理ページの等価性を判断するときに不要なデータを除く、ページのコンテンツの計算チェックサム値にこのメンバーを設定します。たとえば、使用されていないデータベースページ領域のデータ値を考慮する必要があります。このメンバーは、 checksumActual 値と checksumExpected 値が互いに等しい場合にのみ有効です。

ulFlags

64 ビット符号なし整数。将来使用するために予約されています。このフィールドの値は、ErrCheckDbPages を呼び出す前に 0 (ゼロ) に設定しておく必要があります。

注釈

ErrCheckDbPages 関数を呼び出すときには、rgPageInfo パラメーターは PAGE_INFO 構造体の配列になります。確認するデータベースページごとに、1 つの PAGE_INFO 構造体が必要になります。

アプリケーションでは、ErrCheckDbPages を呼び出す前に ulPgno メンバーを適切な値に設定しておく必要があり、ulFlags メンバーを 0 (ゼロ) に設定しておく必要もあります。

要件

Exchange Server 2013 には、CHKSGFILES API の 64 ビットバージョンのみが含まれています。

アプリケーションを実行しているアカウントには、確認するデータベースとログファイルに対する読み取りアクセス許可が必要です。

Share via