JET_ENUMCOLUMN 構造体

[アーティクル]
06/13/2023

適用対象: Windows |Windows Server

JET_ENUMCOLUMN 構造体

JET_ENUMCOLUMN構造体は、JetEnumerateColumns 関数を使用すると、レコードの列値を列挙します。 JetEnumerateColumns は、JET_ENUMCOLUMN構造体の配列を返します。配列は、その API に提供された realloc 互換コールバックを使用して割り当てられたメモリで返されます。

    typedef struct {
      JET_COLUMNID columnid;
      JET_ERR err;
      union {
        struct {
          unsigned long cEnumColumnValue;
          JET_ENUMCOLUMNVALUE rgEnumColumnValue;
        };
        struct {
          unsigned long cbData;
          void* pvData;
        };
      };
    } JET_ENUMCOLUMN;

メンバー

columnid

列挙された列 ID。

err

列の列挙に起因する列の状態コード。

エラーコード	説明
JET_errBadColumnId	列 ID が列 ID の法的制限を超えています。
JET_errColumnNotFound	列 ID によって記述された列がテーブルに存在しません。
JET_wrnColumnNull	この列のすべての値は NULL です。
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnlyが指定され、この列に対して少なくとも 1 つの NULL 以外の列値が返されます。
JET_wrnColumnSingleValue	JET_bitEnumerateCompressOutputが指定され、この列に対して NULL 以外の列値が 1 つだけ返されました。その結果、 JET_ENUMCOLUMN の圧縮形式が返されました。詳細については、「 JET_ENUMCOLUMN 」を参照してください。
JET_wrnColumnSkipped	この JET_ENUMCOLUMN 構造体に対応する JET_ENUMCOLUMNID 構造体の列 ID が 0 でした。

cEnumColumnValue

列に対して列挙された列値の配列。出力バッファーは、JetEnumerateColumns に提供された realloc 互換コールバックを使用して割り当てられたメモリに返されます。

この出力バッファーは、列の状態コードがJET_wrnColumnSingleValueと等しくない場合に使用されます。詳細については、「 JetEnumerateColumns」を参照してください。

これは、"err != JET_wrnColumnSingleValue" の場合に返されます。

rgEnumColumnValue

これは、"err != JET_wrnColumnSingleValue" の場合に返されます。

cbData

列に対して列挙された列の値。

出力バッファーは、JetEnumerateColumns に提供された realloc 互換コールバックを使用して割り当てられたメモリに返されます。

この出力バッファーは、列の状態コードがJET_wrnColumnSingleValueされている場合にのみ使用されます。詳細については、「 JetEnumerateColumns」を参照してください。

これは、"err == JET_wrnColumnSingleValue" の場合に返されます。

pvData

列に対して列挙された列の値。

出力バッファーは、JetEnumerateColumns に提供された realloc 互換コールバックを使用して割り当てられたメモリに返されます。

これは、"err == JET_wrnColumnSingleValue" の場合に返されます。

必要条件

要件	値
Client	Windows Vista、Windows XP、または Windows 2000 Professional が必要です。
[サーバー]	Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。
Header	Esent.h で宣言されています。

参照

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc

次の方法で共有

JET_ENUMCOLUMN 構造体