Struttura JET_ENUMCOLUMN

Si applica a: Windows | Windows Server

Struttura JET_ENUMCOLUMN

La struttura JET_ENUMCOLUMN enumera i valori di colonna di un record quando viene usata la funzione JetEnumerateColumns . JetEnumerateColumns restituisce una matrice di strutture JET_ENUMCOLUMN . La matrice viene restituita in memoria allocata usando il callback compatibile con realloc fornito a tale 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;

Membri

columnid

ID colonna enumerato.

err

Codice di stato della colonna risultante dall'enumerazione della colonna.

Codici errore	Significato
JET_errBadColumnId	L'ID colonna non rientra nei limiti legali di un ID colonna.
JET_errColumnNotFound	La colonna descritta dall'ID colonna non esiste nella tabella.
JET_wrnColumnNull	Tutti i valori per questa colonna sono NULL.
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnly è stato specificato e per questa colonna è stato restituito almeno un valore di colonna non NULL.
JET_wrnColumnSingleValue	JET_bitEnumerateCompressOutput è stato specificato e viene restituito esattamente un valore di colonna non NULL per questa colonna. Di conseguenza, la forma compressa di JET_ENUMCOLUMN è stata restituita. Per altre informazioni , vedere JET_ENUMCOLUMN .
JET_wrnColumnSkipped	L'ID colonna nello struct JET_ENUMCOLUMNID corrispondente a questo struct JET_ENUMCOLUMN era zero.

cEnumColumnValue

Matrice di valori di colonna enumerati per la colonna. Il buffer di output viene restituito in memoria allocato usando il callback compatibile con realloc fornito a JetEnumerateColumns.

Questo buffer di output viene usato quando il codice di stato della colonna non è uguale a JET_wrnColumnSingleValue. Per altre informazioni, vedere JetEnumerateColumns.

Viene restituito se "err != JET_wrnColumnSingleValue".

rgEnumColumnValue

Matrice di valori di colonna enumerati per la colonna. Il buffer di output viene restituito in memoria allocato usando il callback compatibile con realloc fornito a JetEnumerateColumns.

Questo buffer di output viene usato quando il codice di stato della colonna non è uguale a JET_wrnColumnSingleValue. Per altre informazioni, vedere JetEnumerateColumns.

Viene restituito se "err != JET_wrnColumnSingleValue".

cbData

Valore della colonna enumerato per la colonna.

Il buffer di output viene restituito in memoria allocato usando il callback compatibile con realloc fornito a JetEnumerateColumns.

Questo buffer di output viene usato solo quando il codice di stato della colonna è JET_wrnColumnSingleValue. Per altre informazioni, vedere JetEnumerateColumns.

Viene restituito se "err == JET_wrnColumnSingleValue".

pvData

Valore della colonna enumerato per la colonna.

Il buffer di output viene restituito in memoria allocato usando il callback compatibile con realloc fornito a JetEnumerateColumns.

Questo buffer di output viene usato solo quando il codice di stato della colonna è JET_wrnColumnSingleValue. Per altre informazioni, vedere JetEnumerateColumns.

Viene restituito se "err == JET_wrnColumnSingleValue".

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Dichiarato in Esent.h.

Vedere anche

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc