JetOpenFile 関数

適用対象: Windows |Windows Server

JetOpenFile 関数

JetOpenFile 関数は、ストリーミング あいまいバックアップを実行するために、アクティブなインスタンスのアタッチされたデータベース、データベース パッチ ファイル、またはトランザクション ログ ファイルを開きます。 これらのファイルのデータは、 JetReadFile を使用して、返されたハンドルを介して読み取ることができます。 返されるハンドルは、 JetCloseFile を使用して閉じる必要があります。 インスタンスの外部バックアップは、 JetBeginExternalBackup を使用して以前に開始されている必要があります。

    JET_ERR JET_API JetOpenFile(
      __in          const tchar* szFileName,
      __out         JET_HANDLE* phfFile,
      __out         unsigned long* pulFileSizeLow,
      __out         unsigned long* pulFileSizeHigh
    );

パラメーター

szFileName

バックアップ用に読み取られるインスタンスによって管理される、アタッチされたデータベース、データベース パッチ ファイル、またはトランザクション ログ ファイルへの相対パスまたは絶対パス。

phfFile

読み取るファイルへのハンドルを受け取る出力バッファー。

pulFileSizeLow

ファイルのサイズの下位 32 ビットを受け取る出力バッファー。

pulFileSizeHigh

ファイルのサイズの最も重要な 32 ビットを受け取る出力バッファー。

戻り値

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

成功すると、要求されたファイルへのハンドルが返されます。 ハンドルがデータベース ファイルの場合、そのデータベース ファイルはストリーミング バックアップ用に準備され、データベース ファイルと同じ場所にデータベース パッチ ファイルが作成される可能性があります。 データベース パッチ ファイルには、データベース ファイルとまったく同じパスとファイル名がありますが、 があります。PAT 拡張機能。 ファイルのサイズも返されます。

失敗した場合、出力バッファーの状態は未定義になります。 データベースパッチファイルはディスク上に一時的に作成され、パッチファイルの場所にある既存のファイルは削除される可能性があります。 エラーが発生すると、インスタンスのバックアップ プロセス全体が取り消されます。 Windows XP 以降のリリースでは、呼び出し時にインスタンスにアタッチされていないデータベースをバックアップしようとした場合、バックアップは取り消されません。

警告 セキュリティ上の理由から、 JetOpenFile では、要求されたファイル パスがインスタンス用にバックアップする必要があるファイルのセットに関連付けられていることを確認しないことに注意してください。 その結果、この関数を使用して、スレッドの現在のセキュリティ コンテキストで開くことができるすべてのファイルにアクセスできます。 アプリケーションでは、この関数に渡されるパスを既知の適切なファイル パスのセットに制限するか、情報攻撃の開示を可能にすることが不可欠です。

注釈

ハンドルとファイル サイズの出力バッファーが存在する必要があります。 存在しない場合、出力バッファー パラメーターが検証されないため、エンジンがクラッシュします。

現時点では、バックアップ用に一度に開くことができるファイルは 1 つだけです。

JetOpenFile は、要求されたファイルを開く前にバックアップ特権をアサートしません。

この関数によって報告される読み取り対象ファイルのサイズが、ディスク上のファイルのサイズと一致しない可能性があります。 Windows XP 以降のリリースでは、復元操作中にデータベース エンジンによって使用されるデータベース ファイルに追加情報が追加される場合があります。 そのため、アプリケーションは JetOpenFile によって返されるファイル サイズ、または JetReadFile によって返されるデータの実際のバイト数にのみ依存する必要があります。

要件

参照

JET_ERR
JET_HANDLE
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetGetAttachInfo
JetGetLogInfo
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog