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). |