Estructura de JET_RETINFO

Se aplica a: Windows | Windows Server

Estructura de JET_RETINFO

La estructura JET_RETINFO contiene parámetros de entrada y salida opcionales para JetRetrieveColumn. Se puede pasar un puntero nulo donde se pasaría un puntero a esta estructura. Pasar un puntero nulo es el mismo que pasar JET_RETINFO con cbStruct establecido en sizeof(JET_RETINFO), ibLongValue establecido en 0 (cero) y itagSequence establecido en 1.

    typedef struct {
      unsigned long cbStruct;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
    } JET_RETINFO;

Miembros

cbStruct

Debe establecerse en el tamaño de la estructura de JET_RETINFO , en bytes, y sirve para confirmar la presencia de los campos siguientes.

ibLongValue

Desplazamiento al primer byte que se va a recuperar de una columna de tipo JET_coltypLongBinary o JET_coltypLongText. Tenga en cuenta que la cantidad de datos recuperados de este desplazamiento es el menor del tamaño del búfer de salida y el tamaño de los datos en el valor real después de este desplazamiento.

itagSequence

Describe el número de secuencia de valor en una columna con varios valores. Tenga en cuenta que la matriz de valores está basada en uno. El primer valor es la secuencia 1, no 0. Si la columna de registro tiene solo un valor, se debe pasar 1 como itagSequence.

Con una columna que puede contener varios valores, solo es posible usar un número de secuencia mayor que 1 en JetSetColumn y JetRetrieveColumn o 0 en JetSetColumn. En la implementación actual del motor, cualquier columna que se creó con JET_bitColumnTagged puede contener varios valores. Las columnas creadas con JET_bitColumnMultiValued difieren de las columnas etiquetadas con varios valores solo en la forma en que se indexan. Consulte JET_INDEXCREATE para obtener más información.

columnidNextTagged

Devuelve el columnid de la columna etiquetada, con varios valores o dispersos recuperados, cuando todas las columnas etiquetadas se recuperan pasando 0 como columnid a JetRetrieveColumn.

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_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn