Share via


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

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetDeleteColumn2