JetDeleteColumn-Funktion

Gilt für: Windows | Windows Server

JetDeleteColumn-Funktion

Die JetDeleteColumn-Funktion löscht eine Spalte aus einer ESE-Datenbanktabelle.

JET_ERR JET_API JetDeleteColumn(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in          const tchar* szColumnName
);

Parameter

sesid

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

tableid

Die Tabelle, aus der die Spalte gelöscht werden soll.

szColumnName

Der Name der zu löschenden Spalte.

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_errColumnInUse

Die Spalte wird derzeit verwendet. Sie kann derzeit von einem Index verwendet werden.

JET_errFixedDDL

Es wurde versucht, die feste DDL zu ändern.

JET_errFixedInheritedDDL

Die Spalte mit dem Namen in szColumnName ist in der Vorlagentabelle vorhanden, und die DDL einer Vorlagentabelle kann nicht geändert werden.

JET_errInvalidName

Dies kann zurückgegeben werden, wenn ein ungültiger Name für szColumnName angegeben wurde.

JET_errPermissionDenied

Die Tabelle ist nicht beschreibbar. Dies wird möglicherweise zurückgegeben, wenn die Datenbank im schreibgeschützten Modus geöffnet wurde.

JET_errTransReadOnly

Die Transaktion ist eine schreibgeschützte Transaktion.

Bemerkungen

Das Aufrufen von JetDeleteColumn ist identisch mit dem Aufrufen von JetDeleteColumn2 , wobei grbit auf null (0) festgelegt ist.

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 JetDeleteColumnW (Unicode) und JetDeleteColumnA (ANSI).

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetDeleteColumn2