Método Api.JetEnumerateColumns

  • Artículo

Recupera eficazmente un conjunto de columnas y sus valores del registro actual de un cursor o del búfer de copia de ese cursor. Las columnas y los valores recuperados se pueden restringir mediante una lista de identificadores de columna, números itagSequence y otras características. Esta API de recuperación de columnas es única en que devuelve información en la memoria asignada dinámicamente que se obtiene mediante una devolución de llamada compatible con realloc proporcionada por el usuario. Esta nueva flexibilidad permite la recuperación eficaz de los datos de columna con características específicas (como el tamaño y la multiplicidad) que son desconocidos para el autor de la llamada. Esto elimina la necesidad de usar los modos de detección de JetRetrieveColumn para determinar esas características con el fin de configurar una llamada final a JetRetrieveColumn que recuperará correctamente los datos deseados.

Esta API no es conforme a CLS. 

Espacio de nombres:Microsoft.Isam.Esent.Interop
Ensamblaje: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Sintaxis

'Declaration
<CLSCompliantAttribute(False)> _
Public Shared Function JetEnumerateColumns ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    numColumnids As Integer, _
    columnids As JET_ENUMCOLUMNID(), _
    <OutAttribute> ByRef numColumnValues As Integer, _
    <OutAttribute> ByRef columnValues As JET_ENUMCOLUMN(), _
    allocator As JET_PFNREALLOC, _
    allocatorContext As IntPtr, _
    maxDataSize As Integer, _
    grbit As EnumerateColumnsGrbit _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim numColumnids As Integer
Dim columnids As JET_ENUMCOLUMNID()
Dim numColumnValues As Integer
Dim columnValues As JET_ENUMCOLUMN()
Dim allocator As JET_PFNREALLOC
Dim allocatorContext As IntPtr
Dim maxDataSize As Integer
Dim grbit As EnumerateColumnsGrbit
Dim returnValue As JET_wrn

returnValue = Api.JetEnumerateColumns(sesid, _
    tableid, numColumnids, columnids, _
    numColumnValues, columnValues, allocator, _
    allocatorContext, maxDataSize, grbit)

[CLSCompliantAttribute(false)]
public static JET_wrn JetEnumerateColumns(
    JET_SESID sesid,
    JET_TABLEID tableid,
    int numColumnids,
    JET_ENUMCOLUMNID[] columnids,
    out int numColumnValues,
    out JET_ENUMCOLUMN[] columnValues,
    JET_PFNREALLOC allocator,
    IntPtr allocatorContext,
    int maxDataSize,
    EnumerateColumnsGrbit grbit
)

Parámetros

  • numColumnids
    Tipo: System.Int32

    Número de JET_ENUMCOLUMNIDS.

  • columnids
    Tipo: []

    Matriz opcional de identificadores de columna, cada una con una matriz opcional de números itagSequence que se van a enumerar.

  • numColumnValues
    Tipo: System.Int32

    Devuelve el número de valores de columna recuperados.

  • columnValues
    Tipo: []

    Devuelve los valores de columna enumerados.

  • allocatorContext
    Tipo: System.IntPtr

    Contexto de la devolución de llamada de asignación.

  • maxDataSize
    Tipo: System.Int32

    Establece un límite en la cantidad de datos que se van a devolver de una columna binaria larga o de texto largo. Este parámetro se puede usar para evitar la enumeración de un valor de columna extremadamente grande.

Valor devuelto

Tipo: Microsoft.Isam.Esent.Interop.JET_wrn
Advertencia o operación correcta.

Vea también

Referencia

Clase de API

Miembros de api

Espacio de nombres Microsoft.Isam.Esent.Interop