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