Estrutura JET_ENUMCOLUMN

Aplica-se a: Windows | Windows Server

Estrutura JET_ENUMCOLUMN

A estrutura JET_ENUMCOLUMN enumera os valores de coluna de um registro quando a função JetEnumerateColumns é usada. JetEnumerateColumns retorna uma matriz de estruturas JET_ENUMCOLUMN . A matriz é retornada na memória alocada usando o retorno de chamada compatível com realloc que foi fornecido a essa 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;

Membros

Columnid

A ID da coluna que foi enumerada.

err

A coluna status código que resulta da enumeração da coluna.

Códigos de erro	Significado
JET_errBadColumnId	A ID da coluna está fora dos limites legais de uma ID de coluna.
JET_errColumnNotFound	A coluna descrita pela ID da coluna não existe na tabela.
JET_wrnColumnNull	Todos os valores dessa coluna são NULL.
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnly foi especificado e pelo menos um valor de coluna não NULL teria sido retornado para essa coluna.
JET_wrnColumnSingleValue	JET_bitEnumerateCompressOutput foi especificado e exatamente um valor de coluna não NULL foi retornado para esta coluna. Como resultado, a forma compactada de JET_ENUMCOLUMN foi retornada. Confira JET_ENUMCOLUMN para obter mais informações.
JET_wrnColumnSkipped	A ID da coluna no struct JET_ENUMCOLUMNID correspondente a esse struct JET_ENUMCOLUMN era zero.

cEnumColumnValue

A matriz de valores de coluna que foi enumerada para a coluna. O buffer de saída é retornado na memória alocada usando o retorno de chamada compatível com realloc que foi fornecido a JetEnumerateColumns.

Esse buffer de saída é usado quando a coluna status código não é igual a JET_wrnColumnSingleValue. Para obter mais informações, consulte JetEnumerateColumns.

Isso será retornado se "err != JET_wrnColumnSingleValue".

rgEnumColumnValue

A matriz de valores de coluna que foi enumerada para a coluna. O buffer de saída é retornado na memória alocada usando o retorno de chamada compatível com realloc que foi fornecido a JetEnumerateColumns.

Esse buffer de saída é usado quando a coluna status código não é igual a JET_wrnColumnSingleValue. Para obter mais informações, consulte JetEnumerateColumns.

Isso será retornado se "err != JET_wrnColumnSingleValue".

cbData

O valor da coluna que foi enumerado para a coluna.

O buffer de saída é retornado na memória alocada usando o retorno de chamada compatível com realloc que foi fornecido a JetEnumerateColumns.

Esse buffer de saída só é usado quando a coluna status código é JET_wrnColumnSingleValue. Para obter mais informações, consulte JetEnumerateColumns.

Isso será retornado se "err == JET_wrnColumnSingleValue".

pvData

O valor da coluna que foi enumerado para a coluna.

O buffer de saída é retornado na memória alocada usando o retorno de chamada compatível com realloc que foi fornecido a JetEnumerateColumns.

Esse buffer de saída só é usado quando a coluna status código é JET_wrnColumnSingleValue. Para obter mais informações, consulte JetEnumerateColumns.

Isso será retornado se "err == JET_wrnColumnSingleValue".

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.

Consulte Também

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc