JetGetTableIndexInfo-Funktion

Gilt für: Windows | Windows Server-

JetGetTableIndexInfo-Funktion

Die JetGetTableIndexInfo-Funktion ruft Informationen zu einem Index ab.

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

Parameter

sesid

Der Datenbanksitzungskontext, der für den API-Aufruf verwendet werden soll.

tableid

Die Datenbanktabelle, die den Index enthält, der die erforderlichen Informationen enthält.

szIndexName

Der Name des Indexes, der Informationen enthält, die abgerufen werden.

pvResult

Zeigen Sie auf einen Puffer, der die Informationen empfängt. Der Puffer sollte für den erforderlichen Typ ausgerichtet werden. Der Typ des Puffers ist vom InfoLevel-Parameter abhängig.

cbResult

Die Größe des Puffers in Bytes, der im pvResult-Parameter übergeben wird.

InfoLevel

Gibt an, welche Informationen in pvResult gespeichert werden. Die gültigen Werte sind:

Wert

Bedeutung

JET_IdxInfo

pvResult wird als JET_INDEXLIST Struktur interpretiert. Bei Erfolg erhält die JET_INDEXLIST-Struktur Informationen zum Index. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoLCID

pvResult wird als LCID interpretiert. Bei Erfolg enthält die LCID den Gebietsschemabezeichner des Indexes. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoList

pvResult wird als JET_INDEXLIST Struktur interpretiert. Bei Erfolg erhält die JET_INDEXLIST-Struktur Informationen zum Index. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoOLC

JET_IdxInfoOLC ist veraltet.

JET_IdxInfoResetOLC

JET_IdxInfoResetOLC ist veraltet.

JET_IdxInfoSpaceAlloc

pvResult wird als ULONG interpretiert. Bei Erfolg hält die ULONG die Raumnutzung des Indexes. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoSysTabCursor

JET_IdxInfoSysTabCursor ist veraltet.

JET_IdxInfoLangid

JET_IdxInfoLangid ist veraltet. Verwenden Sie stattdessen JET_IdxInfoLCID und das LANGIDFROMLCID-Makro .

JET_IdxInfoCount

pvResult wird als ULONG interpretiert. Bei Erfolg enthält die ULONG die Anzahl der Indizes in der angegebenen Tabelle. szIndexName wird ignoriert. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoVarSegMac

pvResult wird als USHORT interpretiert. Bei Erfolg enthält die USHORT den Wert von cbVarSegMac , der beim Erstellen des Indexes verwendet wurde. Eine Beschreibung von cbVarSegMac finden Sie unter JET_INDEXCREATE. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoIndexId

pvResult wird als JET_INDEXID interpretiert. Bei Erfolg erhält die JET_INDEXID Struktur Informationen zum Index. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoKeyMost

pvResult wird als USHORT interpretiert. Bei Erfolg enthält die USHORT den Wert von cbKeyMost, der beim Erstellen des Indexes verwendet wurde. Eine Beschreibung von cbKeyMost finden Sie in der JET_INDEXCREATE Struktur. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

JET_IdxInfoCreateIndex

pvResult wird als JET_INDEXCREATE Struktur interpretiert. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

Windows 7: JET_IdxInfoCreateIndex wird in Windows 7 eingeführt.

JET_IdxInfoCreateIndex2

pvResult wird als JET_INDEXCREATE2 Struktur interpretiert. Bei Ausfall sind die Inhalte von pvBuffer nicht definiert.

Windows 7: JET_IdxInfoCreateIndex2 wird in Windows 7 eingeführt.
JET_IdxInfoSpaceOwned pvResult wird als ein ULONG. Bei Erfolg enthält die ULONG Anzahl der Seiten, die im Besitz des Index sind. Weitere Informationen finden Sie unter Hinweise.

Windows 11:JET_IdxInfoSpaceOwned wird in Windows 11 eingeführt.
JET_IdxInfoSpaceAvail pvResult wird als ein ULONG. Bei Erfolg enthält die ULONG Anzahl der im Index verfügbaren Seiten. Weitere Informationen finden Sie unter Hinweise.

Windows 11:JET_IdxInfoSpaceAvail wird in Windows 11 eingeführt.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Description

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errIndexNotFound

Der angegebene Index wurde in der angegebenen Tabelle nicht gefunden.

JET_wrnBufferTruncated

Der als pvResult übergebene Puffer war zu klein. Der Inhalt des Puffers ist nicht definiert.

Hinweise

JetGetIndexInfo und JetGetTableIndexInfo rufen identische Informationen zu einem Index ab. Der Unterschied besteht darin, wie die Tabelle angegeben wird. JetGetIndexInfo erwartet eine Datenbank (dbid) und den Namen einer Tabelle (szTableName), während JetGetTableIndexInfo einen Tabellenbezeichner (Tableid) erwartet.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.

Header

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Unicode

Implementiert als JetGetTableIndexInfoW (Unicode) und JetGetTableIndexInfoA (ANSI).

Siehe auch

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JET_INDEXCREATE2JET_INDEXID
JET_INDEXLISTJetGetIndexInfo

  • Last updated on