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