JetDeleteColumn2-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetDeleteColumn2-Funktion
Die Funktion JetDeleteColumn2 löscht eine Spalte aus einer Datenbanktabelle ESE und ermöglicht eine JET_errInvalidGrbit Option festgelegt werden soll.
Windows XP: JetDeleteColumn2 wird in Windows XP eingeführt.
JET_ERR JET_API JetDeleteColumn2(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName,
__in const JET_GRBIT grbit
);
Parameter
sesid
Der Kontext, für den API-Aufruf zu verwendenden Datenbank Sitzung.
TableID
Die Tabelle, die zu löschenden Spalte enthält.
szColumnName
Der Name der Spalte gelöscht werden soll.
JET_errInvalidGrbit
Eine Gruppe von Bits 0 (null) oder mehrere der folgenden Optionen angeben.
Wert |
Bedeutung |
---|---|
JET_bitDeleteColumnIgnoreTemplateColumns |
Festlegen von JET_bitDeleteColumIgnoreTemplateColumns bewirkt, dass die API nur versuchen, Spalten in der abgeleiteten Tabelle zu löschen. Wenn eine Spalte mit diesem Namen in der Basistabelle vorhanden ist, wird sie ignoriert. |
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errColumnInUse |
Die Spalte wird derzeit verwendet. Es kann zurzeit von einem Index verwendet werden. |
JET_errFixedDDL |
Es wurde versucht, um die festen DDL zu ändern. |
JET_errFixedInheritedDDL |
Die Spalte, die mit dem Namen im SzColumnName vorhanden ist, in der Tabelle Vorlage, und die DDL einer Tabelle Vorlage kann nicht geändert werden. |
JET_errInvalidName |
Dies kann zurückgegeben werden, wenn ein ungültiger Name für SzColumnName zugewiesen wurde. |
JET_errPermissionDenied |
Die Tabelle kann nicht geschrieben werden. Dies kann zurückgegeben werden, wenn die Datenbank im schreibgeschützten Modus geöffnet wurde. |
JET_errTransReadOnly |
Die Transaktion ist eine Transaktion schreibgeschützt. |
Anmerkungen
Aufrufen von JetDeleteColumn entspricht aufrufende JetDeleteColumn2 mit JET_errInvalidGrbit auf Null (0) festgelegt.
Voraussetzungen
-Client, |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert WindowsServer 2008 oder WindowsServer 2003. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Unicode |
Implementiert als JetDeleteColumn2W (Unicode) und JetDeleteColumn2A (ANSI). |