Estructura de JET_RETRIEVECOLUMN

Se aplica a: Windows | Windows Server

Estructura de JET_RETRIEVECOLUMN

La estructura JET_RETRIEVECOLUMN contiene parámetros de entrada y salida para JetRetrieveColumns. Los campos de la estructura describen qué valor de columna se va a recuperar, cómo recuperarlos y dónde guardar los resultados.

    typedef struct {
      JET_COLUMNID columnid;
      void* pvData;
      unsigned long cbData;
      unsigned long cbActual;
      JET_GRBIT grbit;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
      JET_ERR err;
    } JET_RETRIEVECOLUMN;

Miembros

columnid

Identificador de columna de la columna que se va a recuperar.

pvData

Puntero para empezar a almacenar los datos que se recuperan del valor de columna.

cbData

Tamaño de la asignación que comienza en pvData, en bytes. La operación recuperar columna no almacenará más datos en pvData que cbData.

cbActual

Tamaño, en bytes, de datos recuperados por una operación de recuperación de columna.

grbit

Grupo de bits que contienen las opciones de recuperación de columnas, que incluyen cero o más de los valores siguientes.

Valor	Significado
JET_bitRetrieveCopy	Recupera el valor modificado en lugar del valor original. Si el valor no se ha modificado, se recupera el valor original. De esta manera, se puede recuperar un valor que aún no se ha insertado o actualizado cuando se inserta o actualiza un registro.
JET_bitRetrieveFromIndex	Recupera los valores de columna del índice sin tener acceso al registro, si es posible. De esta manera, se puede evitar la carga innecesaria de registros cuando los datos necesarios están disponibles en las entradas de índice. En los casos en los que no se pueda recuperar el valor de columna original del índice, debido a transformaciones irreversibles o truncamiento de datos, se tendrá acceso al registro y se recuperarán los datos como normales. Se trata de una opción de rendimiento y solo se debe especificar cuando es probable que el valor de columna se pueda recuperar del índice. Esta opción no se debe especificar si el índice actual es el índice agrupado, ya que las entradas de índice para el clúster o el índice principal son los propios registros. Este bit no se puede establecer si también se establece JET_bitRetrieveFromPrimaryBookmark.
JET_bitRetrieveFromPrimaryBookmark	Recupera los valores de columna del marcador de índice y puede diferir del valor de índice cuando una columna aparece tanto en el índice principal como en el índice actual. Esta opción no se debe especificar si el índice actual es el índice agrupado o principal. Este bit no se puede establecer si también se establece JET_bitRetrieveFromIndex.
JET_bitRetrieveTag	Recupera el número de secuencia de un valor de columna de varios valores en pretinfo-itagSequence>. El campo itagSequence se usa a menudo una entrada para recuperar valores de columna de varios valores de un registro. Sin embargo, al recuperar valores de un índice, también es posible asociar la entrada de índice a un número de secuencia determinado y recuperar también este número de secuencia. Recuperar el número de secuencia puede ser una operación costosa y solo debe realizarse si es necesario.
JET_ bitRetrieveNull	Recupera valores NULL de columna multivalor. Si no se especifica esta opción, se omitirán automáticamente los valores NULL de columna multivalor.
JET_bitRetrieveIgnoreDefault	Hace que se devuelva un valor NULL cuando el número de secuencia solicitado es 1 y no hay valores establecidos para la columna en el registro. Esta opción afecta solo a las columnas con varios valores.
JET_bitRetrieveLongId	Esta marca es solo para uso interno y no está pensada para usarse en la aplicación.
JET_bitRetrieveLongValueRefCount	Esta marca es solo para uso interno y no está pensada para usarse en la aplicación.

ibLongValue

Desplazamiento al primer byte que se va a recuperar de una columna de tipo JET_coltypLongBinary o JET_coltypLongText.

itagSequence

Número de secuencia de los valores contenidos en una columna con varios valores. itagSequence aquí en el JET_RETRIEVECOLUMN puede ser 0. Si itagSequence es 0, el número de instancias de una columna con varios valores se devuelve en lugar de cualquier dato de columna. No se puede usar un valor itagSequence de 0 en llamadas a JetRetrieveColumn.

columnidNextTagged

Columnid de la columna etiquetada, multivalor o dispersa cuando se recuperan todas las columnas etiquetadas pasando 0 como columnid a JetRetrieveColumn.

err

Códigos de error y advertencias devueltos de la recuperación de la columna.

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_ERR
JET_GRBIT
JET_RETRIEVECOLUMN
JetRetrieveColumn
JetRetrieveColumns