Función JetPrereadIndexRanges

  • Artículo

Se aplica a: Windows | Windows Server

La función JetPrereadIndexRanges preprocesa los índices para mejorar el rendimiento.

La función JetPrereadIndexRanges se introdujo en el sistema operativo Windows 8.

JET_ERR JetPrereadIndexRanges(
  __in          const JET_SESID sesid,
  __in          const JET_TABLEID tableid,
  __in_ecount(cIndexRanges)  const JET_INDEX_RANGE* const rgIndexRanges,
  __in          const unsigned long cIndexRanges,
  __out_opt     unsigned long* const pcRangesPreread,
  __in_ecount(ccolumnidPreread)  const JET_COLUMNID* const rgcolumnidPreread,
  __in          const unsigned long ccolumnidPreread,
  __in          const JET_GRBIT grbit
);

Parámetros

sesid

Contexto de sesión de base de datos que se va a usar para la llamada API.

tableid

Tabla en la que se van a emitir los preprocesos.

rgIndexRanges

Intervalos de claves que se van a preprocesar.

cIndexRanges

Número de intervalos de claves que se van a preprocesar, determinados por el número de elementos de rgIndexRanges.

pcRangesPreread

Número de intervalos de claves que realmente estaban preprocesados.

rgcolumnidPreread

Lista de identificadores de columna para las columnas de valor largo que se van a preprocesar. De forma predeterminada, solo el registro en la página está preprocesado. Si las columnas de valores largos fuera de página deben ser preprocesadas, sus identificadores de columna deben pasarse a través de este parámetro.

ccolumnidPreread

Número de identificadores de columna para las columnas de valor largo que se van a preprocesar, determinadas por el número de elementos de rgcolumnidPreread.

grbit

Grupo de bits que especifica cero o más de los valores de dirección de preproceso enumerados en la tabla siguiente.

Valor

Significado

Adelante

Reenvío previo.

Atrás

Preproceso hacia atrás.

FirstPageOnly

Preproceso solo la primera página de cualquier columna larga.

NormalizedKey

Clave o marcador normalizado proporcionado en lugar de un valor de columna.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los códigos de retorno enumerados en la tabla siguiente. Para obtener más información sobre los posibles errores del motor de almacenamiento extensible (ESE), vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto

Descripción

JET_errSuccess

La operación se ha completado correctamente.

Comentarios

Si los registros con los intervalos de claves especificados no están en la memoria caché del búfer, debe iniciar lecturas asincrónicas para introducir los registros en la memoria caché del búfer de base de datos.

Requisitos

Requisito Value

Cliente

Requiere Windows 8.

Servidor

Requiere Windows Server 2012.

Encabezado

Declarado en Esent.h.

Library

Use ESENT.lib.

Archivo DLL

Requiere ESENT.dll.

Consulte también

JET_ERR