JetCreateIndex-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetCreateIndex-Funktion
Die JetCreateIndex -Funktion können Sie einen Index der Daten in einer Datenbank Extensible Storage Engine (ESE) erstellen, die Sie verwenden können, um bestimmte Daten schnell zu finden.
JET_ERR JET_API JetCreateIndex(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_PCSTR szIndexName,
__in JET_GRBIT grbit,
__in const tchar* szKey,
__in unsigned long cbKey,
__in unsigned long lDensity
);
Parameter
sesid
Der Datenbank Sitzungskontext für einen bestimmten API-Aufruf verwenden.
TableID
Die Tabelle, der für ein Index erstellt wird.
szIndexName
Ein Zeiger auf eine Null endende Zeichenfolge, die den Namen des zu erstellenden Indexes angibt.
Den Namen des Indexes muss die folgenden Richtlinien entsprechen:
Er muss weniger Zeichen als JET_cbNameMost, einschließlich nicht abschließende Null-Zeichen enthalten.
Es dürfen nur Zeichen aus den folgenden Kategorien: 0 bis 9, A bis Z, a bis z und alle Interpunktionszeichen mit Ausnahme von "!" (Ausrufezeichen) "," (Komma), "[" (öffnende eckige Klammer) und "]" (schließende eckige Klammer) – d. h., die ASCII-Zeichen 0 x 20, 0 x 22 über 0x2d, 0x2f über 0x5a, 0x5c und 0x5d bis 0x7f.
Es darf nicht mit einem Leerzeichen beginnen.
Es muss mindestens ein nicht-Leerzeichen enthalten.
JET_errInvalidGrbit
Eine Gruppe von Bits mit den Optionen für einen bestimmten Anruf verwendet werden soll. Dieser Parameter kann 0 (null) oder mehrere der Optionen in der Struktur JET_INDEXCREATE enthalten.
szKey
Ein Zeiger auf eine doppelte Null endende Zeichenfolge der Token Null getrennte.
Weitere Informationen zu diesem Parameter finden Sie unter der Struktur JET_INDEXCREATE .
cbKey
Die Länge des Parameters SzKey , einschließlich der zwei Abbruch Null-Zeichen in Bytes.
lDensity
Prozentsatz der anfänglichen B + Indexstruktur Dichte.
Weitere Informationen zu diesem Parameter finden Sie unter der Struktur JET_INDEXCREATE .
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Bedeutung |
---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
Eine Liste der weiteren Fehlern, die von der Funktion JetCreateIndex zurückgegeben werden kann, finden Sie unter JetCreateIndex2.
Anmerkungen
Aufrufen der JetCreateIndex -Funktion ist identisch mit dem Aufruf der Funktion JetCreateIndex2 mit einer JET_INDEXCREATE Struktur mit denselben Einstellungen wie die Parameter der JetCreateIndexund einen cIndexCreate -Parameter gleich 1. Für die Felder der JET_INDEXCREATE -Struktur, die keine entsprechenden Parameter in JetCreateIndexvorhanden sind, wird der Wert 0 angenommen.
Beachten Sie, dass JetCreateIndex von JetCreateIndex2abgelöst wurde.
Voraussetzungen
Client- |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt. |
Kopfzeile |
Wird in Esent.h deklariert. |
Bibliothek |
ESENT.lib verwendet. |
DLL |
Erfordert "ESENT.dll". |
Unicode |
Wird als JetCreateIndexW (Unicode) und JetCreateIndexA (ANSI) implementiert. |
Siehe auch
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JetCreateIndex2
JetCreateTableColumnIndex
JetCreateTableColumnIndex2