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