JetDeleteIndex-Funktion

  • Artikel

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