Función JetDeleteColumn
Se aplica a: Windows | Windows Server
Función JetDeleteColumn
La función JetDeleteColumn elimina una columna de una tabla de base de datos ESE.
JET_ERR JET_API JetDeleteColumn(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName
);
Parámetros
sesid
Contexto de sesión de base de datos que se va a usar para la llamada API.
tableid
Tabla de la que se va a eliminar la columna.
szColumnName
Nombre de la columna que se va a eliminar.
Valor devuelto
Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.
Código devuelto |
Descripción |
---|---|
JET_errSuccess |
La operación se ha completado correctamente. |
JET_errColumnInUse |
La columna está actualmente en uso. Actualmente, un índice puede usarlo. |
JET_errFixedDDL |
Se intentó modificar el DDL fijo. |
JET_errFixedInheritedDDL |
La columna denominada en szColumnName existe en la tabla de plantilla y no se puede modificar el DDL de una tabla de plantilla. |
JET_errInvalidName |
Esto puede devolverse si se ha proporcionado un nombre incorrecto para szColumnName . |
JET_errPermissionDenied |
La tabla no se puede escribir. Esto puede devolverse si la base de datos se abrió en modo de solo lectura. |
JET_errTransReadOnly |
La transacción es una transacción de solo lectura. |
Observaciones
Llamar a JetDeleteColumn es idéntico a llamar a JetDeleteColumn2 con grbit establecido en cero (0).
Requisitos
Requisito | Value |
---|---|
Cliente |
Requiere Windows Vista, Windows XP o Windows 2000 Professional. |
Servidor |
Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server. |
Encabezado |
Declarado en Esent.h. |
Library |
Use ESENT.lib. |
Archivo DLL |
Requiere ESENT.dll. |
Unicode |
Se implementa como JetDeleteColumnW (Unicode) y JetDeleteColumnA (ANSI). |