JET_PFNSTATUS コールバック関数

適用対象: Windows |Windows Server

JET_PFNSTATUS コールバック関数

JET_PFNSTATUSコールバック関数は、最適化、バックアップ、復元操作など、実行時間の長い操作の進行状況に関する情報を受け取ります。 このような操作の間、データベース エンジンはこのコールバック関数を呼び出して、操作の進行状況を更新します。

    JET_ERR JET_API JET_PFNSTATUS(
                           JET_SESID  sesid,
                           JET_SNP snp,
                           JET_SNT snt,
                           void* pv
    );

パラメーター

sesid

実行時間の長い関数が呼び出 された型の セッションJET_SESID。

Snp

JET_SNPで指定された操作の種類。 操作の種類には、修復、圧縮、復元、バックアップ、更新、スクラブ、およびレコード形式の更新が含まれます。

Snt

操作の状態。 状態の種類には、開始、進行中、完了、または失敗が含まれます。 状態は、 JET_SNT型の 3 番目のパラメーターで指定されます。

pv

JET_SNPROG型の構造体への省略可能なポインター。

戻り値

この関数は、JET_ERR データ型 を返します。このデータ型には 、Extensible Storage Engine エラー コードのいずれかが含まれます。 考えられる ESE エラーの詳細については、「 拡張可能ストレージ エンジン エラー 」および「 エラー処理パラメーター」を参照してください。

成功すると、コールバックを発行した操作を正常に続行できます。 場合によっては、コールバックがその操作に影響を与える警告を返す場合があります。

失敗した場合、コールバックを発行した操作は正常に続行されるか、失敗する可能性があります。

注釈

このコールバック関数は、構造体が進行状況の現在の状態を示す進行状況通知で使用されます。 コールバック関数は、操作の進行状況に対して複数回呼び出される可能性があることに注意してください。

要件

参照

拡張可能ストレージ エンジンのエラー コード
記憶域エンジンの拡張可能なエラー
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT