JET_ENUMCOLUMN 結構

發行項
06/12/2023

適用于： Windows |Windows Server

JET_ENUMCOLUMN 結構

使用JetEnumerateColumns函式時，JET_ENUMCOLUMN結構會列舉記錄的資料行值。 JetEnumerateColumns 會傳回 JET_ENUMCOLUMN 結構的陣列。陣列會在記憶體中傳回，該記憶體會使用提供給該 API 的重新配置相容回呼。

    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

列舉的資料行識別碼。

err

從資料行列舉產生的資料行狀態碼。

錯誤碼	意義
JET_errBadColumnId	資料行識別碼超出資料行識別碼的法律限制。
JET_errColumnNotFound	資料行識別碼所描述的資料行不存在於資料表中。
JET_wrnColumnNull	此資料行的所有值都是 Null。
JET_wrnColumnPresent	已指定JET_bitEnumeratePresenceOnly，而且此資料行至少會傳回一個非 Null 資料行值。
JET_wrnColumnSingleValue	已指定JET_bitEnumerateCompressOutput，而且此資料行只傳回一個非 Null 資料行值。因此，已傳回壓縮形式的 JET_ENUMCOLUMN 。如需詳細資訊，請參閱JET_ENUMCOLUMN 。
JET_wrnColumnSkipped	對應至這個 JET_ENUMCOLUMN 結構之 JET_ENUMCOLUMNID 結構中的資料行識別碼為零。

cEnumColumnValue

針對資料行列舉的資料行值陣列。輸出緩衝區會在記憶體中傳回，該記憶體是使用提供給JetEnumerateColumns的realloc相容回呼所配置的。

當資料行狀態碼不等於JET_wrnColumnSingleValue時，就會使用此輸出緩衝區。如需詳細資訊，請參閱 JetEnumerateColumns。

如果「err ！= JET_wrnColumnSingleValue」，就會傳回這個值。

rgEnumColumnValue

針對資料行列舉的資料行值陣列。輸出緩衝區會在記憶體中傳回，該記憶體是使用提供給JetEnumerateColumns的realloc相容回呼所配置的。

當資料行狀態碼不等於JET_wrnColumnSingleValue時，就會使用此輸出緩衝區。如需詳細資訊，請參閱 JetEnumerateColumns。

如果「err ！= JET_wrnColumnSingleValue」，就會傳回這個值。

cbData

針對資料行列舉的資料行值。

輸出緩衝區會在記憶體中傳回，該記憶體是使用提供給JetEnumerateColumns的realloc相容回呼所配置的。

只有當資料行狀態碼JET_wrnColumnSingleValue時，才會使用此輸出緩衝區。如需詳細資訊，請參閱 JetEnumerateColumns。

如果「err == JET_wrnColumnSingleValue」，就會傳回這個值。

pvData

針對資料行列舉的資料行值。

輸出緩衝區會在記憶體中傳回，該記憶體是使用提供給JetEnumerateColumns的realloc相容回呼所配置的。

只有當資料行狀態碼JET_wrnColumnSingleValue時，才會使用此輸出緩衝區。如需詳細資訊，請參閱 JetEnumerateColumns。

如果「err == JET_wrnColumnSingleValue」，就會傳回這個值。

規格需求

需求	值
用戶端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
Server	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
標頭	在 Esent.h 中宣告。

另請參閱

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc

共用方式為

JET_ENUMCOLUMN 結構