JetSetColumns 関数
適用対象: Windows |Windows Server
JetSetColumns 関数
JetSetColumns 関数は、JetSetColumn の動作に似ていますが、アプリケーションで 1 回の操作で複数の列値を設定できます。 JET_SETCOLUMN構造体の配列は、設定する列値のセットを記述し、設定する各列値の入力バッファーを記述するために使用されます。
JET_ERR JET_API JetSetColumns(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in_out_opt JET_SETCOLUMN* psetcolumn,
__in unsigned long csetcolumn
);
パラメーター
sesid
この呼び出しに使用するセッション。
tableid
この呼び出しに使用するカーソル。
psetcolumn
1 つ以上の JET_SETCOLUMN 構造体の配列へのポインター。 各構造体には、設定する列値と、設定する列データの取得元の説明が含まれます。
csetcolumn
psetcolumn によって指定された配列内のJET_SETCOLUMN構造体の数。
戻り値
この関数は、次のいずれかの戻りコードを 使用して、JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張ストレージ エンジン エラー と エラー処理パラメーター」を参照してください。
リターン コード |
説明 |
|---|---|
JET_errBadColumnId |
指定された列 ID は、列 ID の法的制限を超えています。 |
JET_errClientRequestToStopJetService |
JetStopService の呼び出しの結果、セッションに関連付けられたインスタンスのすべてのアクティビティが停止したため、操作を完了できません。 |
JET_errColumnIllegalNull |
JET_errNullInvalidと同じです。 |
JET_errColumnNotFound |
指定された columnid によって記述された列がテーブルに存在しません。 |
JET_errColumnNotUpdatable |
コピーの挿入削除の元の更新操作中に長い値を更新しようとしました。 |
JET_errColumnTooBig |
入力バッファーに指定された列値データが、固定長列の場合は自然であるか、固定長テキスト列またはバイナリ列用に構成されているサイズ制限を超えています。 このエラーは、長い列に 1024 バイトを超えるデータを渡し、JET_bitSetIntrinsicLV フラグを設定するときにも返されます。 |
JET_errInstanceUnavailable |
セッションに関連付けられているインスタンスで、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要がある致命的なエラーが発生したため、操作を完了できません。 このエラーは、Windows XP 以降のリリースでのみ返されます。 |
JET_errInvalidBufferSize |
指定された列値のデータ サイズが、固定長データ型の自然なサイズと一致しません。 |
JET_errInvalidColumnType |
挿入操作または更新操作中に自動インクリメント列を更新するか、置換操作中にバージョン列を更新しようとしました。 |
JET_errInvalidgrbit |
指定されたオプションは不明であるか、既知のビット設定の組み合わせが正しくありません。 |
JET_errInvalidParameter |
指定された psetinfo-cbStruct> は、 JET_SETINFO 構造体の有効なサイズではありません。 |
JET_errMultiValuedDuplicate |
列の設定操作で重複する値を作成しようとしましたが、JET_bitSetUniqueMultiValuesまたはJET_bitSetUniqueNormalizedMultiValuesを指定しました。 |
JET_errNotInitialized |
セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。 |
JET_errNotInTransaction |
呼び出し元のセッションがトランザクションに含まれていないときに、長い列値を更新しようとしました。 |
JET_errNullInvalid |
NULL 以外の列を NULL に設定しようとしました。 |
JET_errRecordTooBig |
列の値を入力バッファーの値に設定できませんでした。これは、レコードがページ サイズ関連のサイズ制限を超える原因となったためです。 JET_coltypLongText型またはJET_coltypLongBinary型の列は、残りのレコード データとは別に格納できます。 ただし、他の列はレコードと共に格納する必要があり、レコード サイズの制限を超える可能性があります。 長い列でも、リンケージとしてレコード内に 5 バイトの領域が必要です。これにより、JET_errRecordTooBigが返される可能性もあります。 |
JET_errRestoreInProgress |
セッションに関連付けられているインスタンスで復元操作が進行中のため、操作を完了できません。 |
JET_errSessionSharingViolation |
同じセッションを複数のスレッドに同時に使用することはできません。 このエラーは、Windows XP 以降のリリースでのみ返されます。 |
JET_errTermInProgress |
セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。 |
JET_errUpdateNotPrepared |
カーソルは現在、新しいレコードの挿入または既存のレコードの更新の処理中ではありません。 |
JET_wrnColumnMaxTruncated |
入力バッファー内の列値が可変長列に対して構成された最大長を超え、切り捨てられました。 |
成功すると、psetcolumns で説明されている列ごとに、列値の目的の部分が入力バッファーからコピーされたデータで設定されます。 可変長列に指定された最大長を超えた場合、列データ・セットが切り捨てられた可能性があります。
失敗した場合、カーソル位置は変更されず、コピー バッファー内の列値データは更新されません。
解説
個々の set 列操作でエラーが返された場合、 JetSetColumns 操作全体でエラーが返されます。 一般に、警告は psetcolumns-error> で返され、この関数からのリターン コードでは返されません。 ただし、最後の列セットに警告がある場合、この警告は JetSetColumns 自体から返されます。
要件
| 要件 | 値 |
|---|---|
Client |
Windows Vista、Windows XP、または Windows 2000 Professional が必要です。 |
[サーバー] |
Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。 |
Header |
Esent.h で宣言されています。 |
Library |
ESENT.lib を使用します。 |
[DLL] |
ESENT.dllが必要です。 |
参照
JET_COLTYP
JET_ERR
JET_SESID
JET_TABLEID
JET_SETCOLUMN
JetRetrieveColumns
JetSetColumn