JET_ENUMCOLUMN 結構

適用于：Windows |Windows伺服器

JET_ENUMCOLUMN 結構

使用JetEnumerateColumns函式時，JET_ENUMCOLUMN結構會列舉記錄的資料行值。 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

列舉的資料行識別碼。

犯 錯

資料行狀態碼，其結果為數據行的列舉。

錯誤碼	意義
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