Función JetDeleteColumn2

Se aplica a: Windows | Windows Server

Función JetDeleteColumn2

La función JetDeleteColumn2 elimina una columna de una tabla de base de datos ESE y permite establecer una opción grbit .

Windows XP: JetDeleteColumn2 se presenta en Windows XP.

    JET_ERR JET_API JetDeleteColumn2(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          const tchar* szColumnName,
      __in          const JET_GRBIT grbit
    );

Parámetros

sesid

Contexto de sesión de base de datos que se va a usar para la llamada API.

tableid

Tabla que contiene la columna que se va a eliminar.

szColumnName

Nombre de la columna que se va a eliminar.

grbit

Un grupo de bits que especifica cero o más de las siguientes opciones.

Valor	Significado
JET_bitDeleteColumnIgnoreTemplateColumns	Si se establece JET_bitDeleteColumIgnoreTemplateColumns, la API solo intentará eliminar columnas de la tabla derivada. Si existe una columna de ese nombre en la tabla base, se omitirá.

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos 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. Puede que un índice lo use actualmente.
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	Se puede devolver 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.

Comentarios

Llamar a JetDeleteColumn es idéntico a llamar a JetDeleteColumn2 con grbit establecido en cero (0).

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista o Windows XP.
Servidor	Requiere Windows Server 2008 o Windows Server 2003.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetDeleteColumn2W (Unicode) y JetDeleteColumn2A (ANSI).

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetDeleteColumn