Función JetPrereadIndexRanges

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