Функция JetGetTableIndexInfo

Статья
06/13/2023

Применимо к: Windows | Windows Server

Функция JetGetTableIndexInfo

Функция JetGetTableIndexInfo извлекает сведения об индексе.

    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
    );

Параметры

sesid

Контекст сеанса базы данных, используемый для вызова API.

tableid

Таблица базы данных, содержащая индекс, содержащий необходимые сведения.

szIndexName

Имя индекса, содержащего сведения, которые будут извлечены.

pvResult

Указатель на буфер, который будет получать сведения. Буфер должен быть выровнен для хранения требуемого типа. Тип буфера зависит от параметра InfoLevel .

cbResult

Размер (в байтах) буфера, переданного в параметре pvResult .

InfoLevel

Указывает, какие сведения будут храниться в pvResult. Допустимые значения:

Значение	Значение
JET_IdxInfo	PvResult интерпретируется как JET_INDEXLIST структура. При успешном выполнении структура JET_INDEXLIST получает сведения об индексе. При сбое содержимое pvBuffer не определено.
JET_IdxInfoLCID	PvResult интерпретируется как код кода кода. При успешном выполнении LCID содержит идентификатор языкового стандарта индекса. При сбое содержимое pvBuffer не определено.
JET_IdxInfoList	PvResult интерпретируется как JET_INDEXLIST структура. При успешном выполнении структура JET_INDEXLIST получает сведения об индексе. При сбое содержимое pvBuffer не определено.
JET_IdxInfoOLC	JET_IdxInfoOLC устарело.
JET_IdxInfoResetOLC	JET_IdxInfoResetOLC устарело.
JET_IdxInfoSpaceAlloc	PvResult интерпретируется как ULONG. При успешном выполнении ULONG содержит использование пространства для индекса. При сбое содержимое pvBuffer не определено.
JET_IdxInfoSysTabCursor	JET_IdxInfoSysTabCursor устарело.
JET_IdxInfoLangid	JET_IdxInfoLangid не рекомендуется. Вместо этого используйте JET_IdxInfoLCID и макрос LANGIDFROMLCID .
JET_IdxInfoCount	PvResult интерпретируется как ULONG. При успешном выполнении ULONG содержит количество индексов в указанной таблице. SzIndexName игнорируется. При сбое содержимое pvBuffer не определено.
JET_IdxInfoVarSegMac	PvResult интерпретируется как USHORT. При успешном выполнении USHORT содержит значение cbVarSegMac , используемое при создании индекса. Описание cbVarSegMac см. в JET_INDEXCREATE. При сбое содержимое pvBuffer не определено.
JET_IdxInfoIndexId	PvResult интерпретируется как JET_INDEXID. При успешном выполнении структура JET_INDEXID получает сведения об индексе. При сбое содержимое pvBuffer не определено.
JET_IdxInfoKeyMost	PvResult интерпретируется как USHORT. При успешном выполнении USHORT содержит значение cbKeyMost, используемое при создании индекса. Описание cbKeyMost см . в JET_INDEXCREATE структуре. При сбое содержимое pvBuffer не определено.
JET_IdxInfoCreateIndex	PvResult интерпретируется как JET_INDEXCREATE структура. При сбое содержимое pvBuffer не определено. Windows 7: JET_IdxInfoCreateIndex появилась в Windows 7.
JET_IdxInfoCreateIndex2	PvResult интерпретируется как JET_INDEXCREATE2 структура. При сбое содержимое pvBuffer не определено. Windows 7: JET_IdxInfoCreateIndex2 появилась в Windows 7.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата	Описание
JET_errSuccess	Операция выполнена успешно.
JET_errIndexNotFound	Указанный индекс не найден в указанной таблице.
JET_wrnBufferTruncated	Буфер, переданный как pvResult , был слишком мал. Содержимое буфера не определено.

JetGetIndexInfo и JetGetTableIndexInfo извлекают идентичные сведения об индексе. Разница заключается в том, как указана таблица. JetGetIndexInfo ожидает базу данных (dbid) и имя таблицы (szTableName), а JetGetTableIndexInfo — идентификатор таблицы (tableid).

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Professional.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.
Библиотека	Используйте ESENT.lib.
DLL	Требуется ESENT.dll.
Юникод	Реализовано как JetGetTableIndexInfoW (Юникод) и JetGetTableIndexInfoA (ANSI).

См. также:

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JET_INDEXID
JetGetIndexInfo

Поделиться через

Функция JetGetTableIndexInfo