CChkSGFiles.ErrCheckDbHeaders 関数

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

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

ErrInit 関数で指定されたデータベースファイルのヘッダーを検証します。この関数は、指定されたデータベースごとのページサイズとページ数も返します。

Vitual ERRErrCheckDbHeaders  
(
        ULONG  * const pcbDbPageSize,
        ULONG  * const pcHeaderPagesPerDb,
        ULONG   const piDbErrorEncountered,
    Const ULONGulFlags = NO_FLAGS
);

パラメーター

pcbDbPageSize

出力パラメーター。指定されたデータベースごとのページサイズ (バイト単位)。

pcHeaderPagesPerDb

出力パラメーターです。内部使用のためにデータベースエンジンによって予約されている、指定された各データベースの先頭にあるページ数。検証のために ErrCheckDbPages 関数にヘッダーページを渡さないでください。

piDbErrorEncountered

出力パラメーターです。関数の戻り値がエラーを示している場合、このパラメーターは ErrInit 関数に渡した rgwszDb[] 配列のインデックスになります。インデックスで示された配列の要素は、エラーが発生したデータベースを表します。関数がエラー値を返さない場合、このパラメーターの値は無効になります。

ulFlags

オプションの入力パラメーター。この値は、将来使用するために予約されています。渡された値は、0 (ゼロ) になります。

戻り値

この関数は、 CChkSGFiles.ERR 列挙型からエラーコードを返します。

注釈

ErrCheckDbHeaders は、ErrInit によって登録したすべてのデータベースで、ログ署名とデータベースページサイズが同じであることを検証します。また、最小の genMin パラメーター値と、最大の genMax パラメーター値を使用することで、登録されたすべてのデータベースをクリーンシャットダウン状態にするために必要になるログファイルのセットを決定することもできます。

piDbErrorEncountered パラメーターは、ゼロ以外の ErrCheckDbHeaders の戻り値で示されるエラーが検出された場合にのみ設定されます。

この関数でエラーが発生すると、エラーイベントが Windows エラーイベントログに追加されます。

ErrCheckDbHeaders は、ErrInit を呼び出した後にのみ呼び出せるようになり、ErrCheckDbPages および ErrCheckLogs を呼び出す前に呼び出す必要があります。

マルチスレッドアプリケーションで CHKSGFILES を使用している場合は、シングルスレッド部分で ErrCheckDbHeaders 関数を呼び出す必要があり、 CCheckSGFiles オブジェクトごとに 1 回だけ呼び出すことができます。

要件

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

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

次の方法で共有