JetDeleteIndex-Funktion

Artikel
07/03/2023

Gilt für: Windows | Windows Server

JetDeleteIndex-Funktion

Die JetDeleteIndex-Funktion löscht einen Index aus einer Tabelle.

    JET_ERR JET_API JetDeleteIndex(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_PCSTR szIndexName
    );

Parameter

sesid

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

tableid

Die Tabelle, die die zu löschende Spalte enthält.

szIndexName

Der Name des zu löschenden Indexes.

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 Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errFixedDDL	Es wurde versucht, einen Index aus einer festen Tabelle zu löschen (z. B. eine tabelle, die mit JET_bitTableCreateFixedDDL erstellt wurde).
JET_errFixedInheritedDDL	Es wurde versucht, einen Index aus einer Vorlagentabelle zu löschen. Eine Vorlagentabelle verfügt über eine feste DDL.
JET_errIndexNotFound	Der Index mit dem Namen in szIndexName wurde nicht gefunden.
JET_errPermissionDenied	Die Tabelle kann nicht aktualisiert werden, da sie schreibgeschützt geöffnet wurde.
JET_errSessionSharingViolation	Mehrere Threads haben versucht, dieselbe Datenbanksitzung zu verwenden.
JET_errTransReadOnly	Die Transaktion wurde als schreibgeschützte Transaktion geöffnet.

Bemerkungen

Bei erfolgreicher Ausführung wird der Index gelöscht und kann daher nicht später verwendet werden. Es darf keine aktive Transaktion mit dem Index geben.

Bei Erfolg wird die Währung vor dem ersten Datensatz festgelegt.

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 JetDeleteIndexW (Unicode) und JetDeleteIndexA (ANSI).

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCreateIndex
JetCreateIndex2

JetDeleteIndex-Funktion