JetGetLogInfoInstance2 関数

適用対象: Windows |Windows Server

JetGetLogInfoInstance2 関数

JetGetLogInfoInstance2 関数は、JetBeginExternalBackup によって開始されたバックアップ中に使用され、バックアップ ファイル セットの一部となるデータベース パッチ ファイルとトランザクション ログ ファイルの名前をインスタンスに照会します。 これらのファイルは、後で JetOpenFile を使用して開き、 JetReadFile を使用して読み取る場合があります。

Windows XP: JetGetLogInfoInstance2 は Windows XP で導入されました。

    JET_ERR JET_API JetGetLogInfoInstance2(
      __in          JET_INSTANCE instance,
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual,
      __in_out_opt  JET_LOGINFO* pLogInfo
    );

パラメーター

instance

この呼び出しに使用するインスタンス。

Windows 2000 の場合、このパラメーターを受け入れる API バリアントは使用できません。サポートされているインスタンスは 1 つだけであるためです。 この場合、この 1 つのグローバル インスタンスの使用が暗黙的に示されます。

Windows XP 以降のリリースでは、このパラメーターを受け入れない API バリアントは、1 つのインスタンスのみがサポートされているレガシ モード (Windows 2000 互換モード) の場合にのみ呼び出すことができます。 それ以外の場合、操作はJET_errRunningInMultiInstanceModeで失敗します。

Szz

バックアップ ファイル セットの一部である必要があるデータベース パッチ ファイルとトランザクション ログ ファイルのセットを記述する null 終了文字列の一覧を受け取る出力バッファー。

このバッファーで返される文字列の一覧は、レジストリで使用される複数文字列と同じ形式です。 null で終わる各文字列は、順番に返され、その後に最終的な null ターミネータが返されます。

cbMax

出力バッファーの最大サイズ (バイト単位)。

pcbActual

出力バッファーで受信した文字列データの実際の量を受け取ります。

pLogInfo

バックアップ ファイル セットの一部であるトランザクション ログ ファイルに関する構造化情報を受け取ります。

このパラメーターが存在しない場合、その値は NULL と見なされます。

戻り値

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

リターン コード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errBackupAbortByServer	JetStopBackup の呼び出しによって現在の外部バックアップが中止されたため、操作は失敗しました。 このエラーは、Windows XP 以降のリリースでのみ返されます。
JET_errClientRequestToStopJetService	JetStopService の呼び出しの結果、セッションに関連付けられたインスタンス上のすべてのアクティビティが停止したため、操作を完了することはできません。
JET_errInstanceUnavailable	セッションに関連付けられているインスタンスで致命的なエラーが発生したため、操作を完了できません。このエラーでは、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要があります。 このエラーは、Windows XP 以降のリリースでのみ返されます。
JET_errInvalidBackupSequence	バックアップ操作が順番に呼び出されたため、失敗しました。 インスタンスに JetOpenFile を使用して作成された未処理のファイル ハンドルがある場合、JetGetLogInfo はこのエラーを返します。
JET_errInvalidParameter	指定されたパラメーターの 1 つに、予期しない値が含まれていたか、別のパラメーターの値と組み合わせると意味のない値が含まれていました。 これは、指定されたインスタンス ハンドルが無効な場合 (Windows XP 以降のリリース) に JetGetLogInfo で発生する可能性があります。
JET_errNoBackup	外部バックアップが進行中でないため、操作は失敗しました。
JET_errNotInitialized	セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。
JET_errRestoreInProgress	セッションに関連付けられているインスタンスで復元操作が進行中であるため、操作を完了できません。
JET_errRunningInMultiInstanceMode	実際に複数のインスタンスが既に存在する場合、1 つのインスタンスのみがサポートされているレガシ モード (Windows 2000 互換モード) でエンジンを使用しようとしたため、操作は失敗しました。
JET_errTermInProgress	セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。

成功すると、バックアップ ファイル セットの一部であるデータベース パッチ ファイルとトランザクション ログ ファイルのセットに関する要求された情報が、指定された出力バッファーに配置されます。 データベース ファイルのバックアップが許可されないように、バックアップステートマシンが高度になります。 データベース パッチ ファイルとトランザクション ログ ファイルのみが、この時点を超えてバックアップ用に開かれます。

失敗した場合、出力バッファーの状態は未定義です。 エラーが発生すると、インスタンスのバックアップ プロセス全体が取り消されます。

注釈

出力バッファーが小さすぎてバックアップ ファイル セットの一部である必要があるファイルの完全な一覧を受け入れられない場合、この API はエラーまたは警告を返さないことを注意してください。 アプリケーションは常に、このリストの実際のサイズを受け取るバッファーを提供し、その情報を使用してリストが切り捨てられたかどうかを判断する必要があります。

要件

要件	値
Client	Windows Vista または Windows XP が必要です。
[サーバー]	Windows Server 2008 または Windows Server 2003 が必要です。
Header	Esent.h で宣言されています。
Library	ESENT.lib を使用します。
[DLL]	ESENT.dllが必要です。
Unicode	JetGetLogInfoInstance2W (Unicode) および JetGetLogInfoInstance2A (ANSI) として実装されます。

参照

JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup