Поделиться через

Функция JetDeleteColumn2

  • Статья

Применимо к: Windows | Windows Server

Функция JetDeleteColumn2

Функция JetDeleteColumn2 удаляет столбец из таблицы базы данных ESE и позволяет задать параметр grbit .

Windows XP: JetDeleteColumn2 появился в Windows XP.

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

Параметры

sesid

Контекст сеанса базы данных, используемый для вызова API.

tableid

Таблица, содержащая удаляемые столбцы.

szColumnName

Имя удаляемого столбца.

grbit

Группа битов, задающая ноль или несколько следующих параметров.

Значение

Значение

JET_bitDeleteColumnIgnoreTemplateColumns

Настройка JET_bitDeleteColumIgnoreTemplateColumns приведет к тому, что API попытается удалить только столбцы в производной таблице. Если столбец с таким именем существует в базовой таблице, он будет игнорироваться.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errColumnInUse

Столбец в настоящее время используется. В настоящее время он может использоваться индексом.

JET_errFixedDDL

Предпринята попытка изменить фиксированный DDL.

JET_errFixedInheritedDDL

Столбец с именем в szColumnName существует в таблице шаблонов, и DDL таблицы шаблонов нельзя изменить.

JET_errInvalidName

Это значение может быть возвращено, если для szColumnName было присвоено неправильное имя.

JET_errPermissionDenied

Таблица не доступна для записи. Это может быть возвращено, если база данных была открыта в режиме только для чтения.

JET_errTransReadOnly

Транзакция доступна только для чтения.

Комментарии

Вызов JetDeleteColumn аналогичен вызову JetDeleteColumn2 с гбитом , равным нулю (0).

Требования

Требование Значение

Клиент

Требуется Windows Vista или Windows XP.

Сервер

Требуется Windows Server 2008 или Windows Server 2003.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

Юникод

Реализовано как JetDeleteColumn2W (Юникод) и JetDeleteColumn2A (ANSI).

См. также:

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetDeleteColumn