Função JetDeleteTable

Aplica-se a: Windows | Windows Server

Função JetDeleteTable

A função JetDeleteTable exclui uma tabela em um banco de dados ESE.

    JET_ERR JET_API JetDeleteTable(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szTableName
    );

Parâmetros

sesid

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

dbid

O identificador de banco de dados a ser usado para a chamada à API.

szTableName

O nome da tabela a ser excluída.

Valor Retornado

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 de 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_errTableInUse

Foi feita uma tentativa de excluir uma tabela enquanto outra sessão tem uma ID de tabela aberta (JET_TABLEID) com JetOpenTable ou JetDupCursor.

JET_errCannotDeletetemporary tabela

Foi feita uma tentativa de excluir uma tabela temporária. Uma tabela temporária é excluída automaticamente quando é fechada com JetCloseTable.

JET_errCannotDeleteTemplateTable

Foi feita uma tentativa de excluir uma tabela de modelo, ou seja, uma tabela da qual a DDL pode ser herdada.

Requisitos

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 JetDeleteTableW (Unicode) e JetDeleteTableA (ANSI).

Consulte Também

JET_DBID
JET_SESID
JetCloseTable