Estructura de JET_ENUMCOLUMN

Se aplica a: Windows | Windows Server

Estructura de JET_ENUMCOLUMN

La estructura JET_ENUMCOLUMN enumera los valores de columna de un registro cuando se usa la función JetEnumerateColumns . JetEnumerateColumns devuelve una matriz de estructuras de JET_ENUMCOLUMN . La matriz se devuelve en memoria que se asigna mediante la devolución de llamada compatible con realloc que se proporcionó a esa 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;

Miembros

columnid

Identificador de columna que se ha enumerado.

err

Código de estado de columna resultante de la enumeración de la columna.

Códigos de error	Significado
JET_errBadColumnId	El identificador de columna está fuera de los límites legales de un identificador de columna.
JET_errColumnNotFound	La columna descrita por el identificador de columna no existe en la tabla.
JET_wrnColumnNull	Todos los valores de esta columna son NULL.
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnly se especificó y se habría devuelto al menos un valor de columna que no sea NULL para esta columna.
JET_wrnColumnSingleValue	JET_bitEnumerateCompressOutput se especificó y se ha devuelto exactamente un valor de columna que no sea NULL para esta columna. Como resultado, se ha devuelto la forma comprimida de JET_ENUMCOLUMN . Consulte JET_ENUMCOLUMN para obtener más información.
JET_wrnColumnSkipped	El identificador de columna del JET_ENUMCOLUMNID estructura correspondiente a este JET_ENUMCOLUMN struct era cero.

cEnumColumnValue

Matriz de valores de columna enumerados para la columna. El búfer de salida se devuelve en memoria que se asignó mediante la devolución de llamada compatible con realloc que se proporcionó a JetEnumerateColumns.

Este búfer de salida se usa cuando el código de estado de columna no es igual a JET_wrnColumnSingleValue. Para obtener más información, consulte JetEnumerateColumns.

Se devuelve si "err != JET_wrnColumnSingleValue".

rgEnumColumnValue

Matriz de valores de columna enumerados para la columna. El búfer de salida se devuelve en memoria que se asignó mediante la devolución de llamada compatible con realloc que se proporcionó a JetEnumerateColumns.

Este búfer de salida se usa cuando el código de estado de columna no es igual a JET_wrnColumnSingleValue. Para obtener más información, consulte JetEnumerateColumns.

Se devuelve si "err != JET_wrnColumnSingleValue".

cbData

Valor de columna enumerado para la columna.

El búfer de salida se devuelve en memoria que se asignó mediante la devolución de llamada compatible con realloc que se proporcionó a JetEnumerateColumns.

Este búfer de salida solo se usa cuando se JET_wrnColumnSingleValue el código de estado de columna. Para obtener más información, consulte JetEnumerateColumns.

Se devuelve si "err == JET_wrnColumnSingleValue".

pvData

Valor de columna enumerado para la columna.

El búfer de salida se devuelve en memoria que se asignó mediante la devolución de llamada compatible con realloc que se proporcionó a JetEnumerateColumns.

Este búfer de salida solo se usa cuando se JET_wrnColumnSingleValue el código de estado de columna. Para obtener más información, consulte JetEnumerateColumns.

Se devuelve si "err == JET_wrnColumnSingleValue".

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.

Consulte también

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc