JetGetErrorInfoW 関数
適用対象: Windows |Windows Server
JetGetErrorInfoW 関数
データベース エンジンの JetGetErrorInfoW 関数BAS_。
注: このドキュメントは、Extensible Storage Engine の暫定的なリリースに基づいています。 この情報は変更されることがあります。
JET_ERR JET_API JetGetErrorInfoW(
_In_opt_ void * pvContext,
_Out_writes_bytes_( cbMax ) void * pvResult,
_In_ unsigned long cbMax,
_In_ unsigned long InfoLevel,
_In_ JET_GRBIT grbit );
パラメーター
pvContext
拡張エラー情報が必要なコンテキストまたはエラー値。 渡される値は 、InfoLevel パラメーターの値によって異なります。
pvResult
情報を受け取るバッファーへのポインター。 バッファーの種類は 、InfoLevel パラメーターの値によって異なります。 バッファーを適切に配置するように呼び出し元を構成する必要があります。
cbMax
渡される pvResult 構造体の最大サイズ。
InfoLevel
エラー情報/コンテキストに対して取得される情報の種類は、 pvContext パラメーターによって指定されます。 pvResult に格納されるデータの形式は InfoLevel に依存します。
次の表に、このパラメーターに使用できる値を示します。
値 |
説明 |
|---|---|
JET_ErrorInfoSpecificErr |
pvContext は JET_ERR/エラー コードとして解釈され、 pvResult は JET_ERRINFOBASIC_Wとして解釈され、 JET_ERRINFOBASIC_W 構造体のフィールドは適切に入力されます。 |
grbit
予約済み。
戻り値
この関数は、次の表に示すリターン コードのいずれかを使用して、 JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張可能ストレージ エンジン エラー 」および「 エラー処理パラメーター」を参照してください。
リターン コード |
説明 |
|---|---|
JET_errSuccess |
操作は正常に完了しました。 |
JET_errInvalidParameter |
指定されたパラメーターの 1 つに予期しない値が含まれているか、別のパラメーターの値と組み合わせると意味のない値が含まれています。 これは、次の場合に JetGetErrorInfo で発生する可能性があります。
|
JET_errDisabledFunctionality |
このウィンドウの SKU でこの関数がサポートされていない場合は、このエラーが返されます。 |
成功すると、要求されたエラー コンテキスト/値に適した出力バッファーが、要求された拡張エラー情報に設定されます。
失敗した場合、出力バッファーの状態は未定義になります。
解説
JET_ERRINFOBASIC_W関数とJET_ERRCAT定数のグループには、InfoLevel = JET_ErrorInfoSpecificErr に対して返される拡張エラー情報に関するドキュメントが含まれています。
要件
| 要件 | 値 |
|---|---|
Client |
Windows 8が必要です。 |
[サーバー] |
サーバー Windows 8必要です。 |
Header |
Esent.h で宣言されています。 |
Library |
ESENT.lib を使用します。 |
[DLL] |
ESENT.dllが必要です。 |
Unicode |
注: JetGetErrorInfoW (Unicode) のみが実装されます。 この API には A (ANSI) バージョンがありません。 |