JetGetTableIndexInfo-Funktion

Artikel
06/12/2023

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 benötigten Informationen enthält.

szIndexName

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

pvResult

Zeiger auf einen Puffer, der die Informationen empfängt. Der Puffer sollte so ausgerichtet sein, dass der erforderliche Typ enthalten ist. 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 sollen. Gültige Werte sind:

Wert	Bedeutung
JET_IdxInfo	pvResult wird als JET_INDEXLIST-Struktur interpretiert. Bei Erfolg empfängt die JET_INDEXLIST-Struktur Informationen über den Index. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert.
JET_IdxInfoLCID	pvResult wird als LCID interpretiert. Bei Erfolg enthält der LCID den Gebietsschemabezeichner des Indexes. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert.
JET_IdxInfoList	pvResult wird als JET_INDEXLIST-Struktur interpretiert. Bei Erfolg empfängt die JET_INDEXLIST-Struktur Informationen über den Index. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert.
JET_IdxInfoOLC	JET_IdxInfoOLC ist veraltet.
JET_IdxInfoResetOLC	JET_IdxInfoResetOLC ist veraltet.
JET_IdxInfoSpaceAlloc	pvResult wird als ULONG interpretiert. Bei Erfolg enthält die ULONG die Speicherplatznutzung des Indexes. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert.
JET_IdxInfoSysTabCursor	JET_IdxInfoSysTabCursor ist veraltet.
JET_IdxInfoLangid	JET_IdxInfoLangid ist veraltet. Verwenden Sie stattdessen JET_IdxInfoLCID und stattdessen das Makro LANGIDFROMLCID .
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 Einem Fehler ist der Inhalt von pvBuffer undefiniert.
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 Einem Fehler ist der Inhalt von pvBuffer undefiniert.
JET_IdxInfoIndexId	pvResult wird als JET_INDEXID interpretiert. Bei Erfolg erhält die JET_INDEXID-Struktur Informationen über den Index. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert.
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 Einem Fehler ist der Inhalt von pvBuffer undefiniert.
JET_IdxInfoCreateIndex	pvResult wird als JET_INDEXCREATE-Struktur interpretiert. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert. Windows 7: JET_IdxInfoCreateIndex wird in Windows 7 eingeführt.
JET_IdxInfoCreateIndex2	pvResult wird als JET_INDEXCREATE2-Struktur interpretiert. Bei Einem Fehler ist der Inhalt von pvBuffer undefiniert. Windows 7: JET_IdxInfoCreateIndex2 wird in Windows 7 eingeführt.

Rückgabewert

Diese Funktion gibt den JET_ERR-Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errIndexNotFound	Der angegebene Index kann in der angegebenen Tabelle nicht gefunden werden.
JET_wrnBufferTruncated	Der als pvResult übergebene Puffer war zu klein. Der Inhalt des Puffers ist nicht definiert.

Bemerkungen

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.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.
Unicode	Implementiert als JetGetTableIndexInfoW (Unicode) und JetGetTableIndexInfoA (ANSI).

Weitere Informationen

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JET_INDEXID
JetGetIndexInfo

JetGetTableIndexInfo-Funktion