Función JetGetTableIndexInfo

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetGetTableIndexInfo

La función JetGetTableIndexInfo recupera información sobre un índice.

    JET_ERR JET_API JetGetTableIndexInfo(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          const tchar* szIndexName,
      __out         void* pvResult,
      __in          unsigned long cbResult,
      __in          unsigned long InfoLevel
    );

Parámetros

sesid

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

tableid

Tabla de base de datos que contiene el índice que contiene la información necesaria.

szIndexName

Nombre del índice que contiene información que se recuperará.

pvResult

Puntero a un búfer que recibirá la información. El búfer debe alinearse para contener el tipo necesario. El tipo del búfer depende del parámetro InfoLevel .

cbResult

Tamaño, en bytes, del búfer pasado en el parámetro pvResult .

InfoLevel

Especifica qué información se almacenará en pvResult. Los valores válidos son:

Valor	Significado
JET_IdxInfo	pvResult se interpreta como una estructura JET_INDEXLIST . Si se ejecuta correctamente, la estructura JET_INDEXLIST recibe información sobre el índice. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoLCID	pvResult se interpreta como un LCID. Si se ejecuta correctamente, el LCID contiene el identificador de configuración regional del índice. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoList	pvResult se interpreta como una estructura JET_INDEXLIST . Si se ejecuta correctamente, la estructura JET_INDEXLIST recibe información sobre el índice. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoOLC	JET_IdxInfoOLC está obsoleto.
JET_IdxInfoResetOLC	JET_IdxInfoResetOLC está obsoleto.
JET_IdxInfoSpaceAlloc	pvResult se interpreta como un ULONG. Si se ejecuta correctamente, ULONG contiene el uso de espacio del índice. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoSysTabCursor	JET_IdxInfoSysTabCursor está obsoleto.
JET_IdxInfoLangid	JET_IdxInfoLangid está en desuso. En su lugar, use JET_IdxInfoLCID y la macro LANGIDFROMLCID .
JET_IdxInfoCount	pvResult se interpreta como un ULONG. Si se ejecuta correctamente, ULONG contiene el recuento de índices en la tabla especificada. se omite szIndexName. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoVarSegMac	pvResult se interpreta como un USHORT. Si se ejecuta correctamente, USHORT contiene el valor de cbVarSegMac utilizado cuando se creó el índice. Consulte JET_INDEXCREATE para obtener una descripción de cbVarSegMac. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoIndexId	pvResult se interpreta como un JET_INDEXID. Si se ejecuta correctamente, la estructura JET_INDEXID recibe información sobre el índice. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoKeyMost	pvResult se interpreta como un USHORT. Si se ejecuta correctamente, USHORT contiene el valor de cbKeyMost usado cuando se creó el índice. Consulte la estructura JET_INDEXCREATE para obtener una descripción de cbKeyMost. En caso de error, el contenido de pvBuffer no está definido.
JET_IdxInfoCreateIndex	pvResult se interpreta como una estructura JET_INDEXCREATE . En caso de error, el contenido de pvBuffer no está definido. Windows 7: JET_IdxInfoCreateIndex se introduce en Windows 7.
JET_IdxInfoCreateIndex2	pvResult se interpreta como una estructura JET_INDEXCREATE2 . En caso de error, el contenido de pvBuffer no está definido. Windows 7: JET_IdxInfoCreateIndex2 se introduce en Windows 7.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errIndexNotFound	No se encuentra el índice especificado en la tabla especificada.
JET_wrnBufferTruncated	El búfer pasado como pvResult era demasiado pequeño. El contenido del búfer no está definido.

Comentarios

JetGetIndexInfo y JetGetTableIndexInfo recuperan información idéntica sobre un índice. La diferencia es la forma en que se especifica la tabla. JetGetIndexInfo espera una base de datos (dbid) y el nombre de una tabla (szTableName), mientras que JetGetTableIndexInfo espera un identificador de tabla (tableid).

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.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetGetTableIndexInfoW (Unicode) y JetGetTableIndexInfoA (ANSI).

Consulte también

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JET_INDEXID
JetGetIndexInfo

Función JetGetTableIndexInfo