Função JetDeleteColumn

Aplica-se a: Windows | Windows Server

A função JetDeleteColumn exclui uma coluna de uma tabela de banco de dados ESE.

JET_ERR JET_API JetDeleteColumn(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in          const tchar* szColumnName
);

sesid

O contexto de sessão de banco de dados a ser usado para a chamada à API.

Tableid

A tabela da qual excluir a coluna.

szColumnName

O nome da coluna a ser excluída.

Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros do ESE, consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Código de retorno	Descrição
JET_errSuccess	A operação foi concluída com sucesso.
JET_errColumnInUse	No momento, a coluna está em uso. Ele pode ser usado atualmente por um índice.
JET_errFixedDDL	Foi feita uma tentativa de modificar a DDL fixa.
JET_errFixedInheritedDDL	A coluna nomeada em szColumnName existe na tabela de modelo e o DDL de uma tabela de modelo não pode ser modificado.
JET_errInvalidName	Isso poderá ser retornado se um nome inválido para szColumnName tiver sido fornecido.
JET_errPermissionDenied	A tabela não é gravável. Isso poderá ser retornado se o banco de dados tiver sido aberto no modo somente leitura.
JET_errTransReadOnly	A transação é uma transação somente leitura.

Chamar JetDeleteColumn é idêntico a chamar JetDeleteColumn2 com grbit definido como zero (0).

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.
Unicode	Implementado como JetDeleteColumnW (Unicode) e JetDeleteColumnA (ANSI).

Comentários