Partilhar via

Função JetDeleteIndex

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetDeleteIndex

A função JetDeleteIndex exclui um índice de uma tabela.

    JET_ERR JET_API JetDeleteIndex(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_PCSTR szIndexName
    );

Parâmetros

sesid

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

Tableid

A tabela que contém a coluna que deve ser excluída.

szIndexName

O nome do índice a ser excluído.

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 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_errFixedDDL

Foi feita uma tentativa de excluir um índice de uma tabela fixa (por exemplo, uma criada com JET_bitTableCreateFixedDDL).

JET_errFixedInheritedDDL

Foi feita uma tentativa de excluir um índice de uma tabela de modelo. Uma tabela de modelos corrigiu o DDL.

JET_errIndexNotFound

O índice nomeado em szIndexName não foi encontrado.

JET_errPermissionDenied

A tabela não pode ser atualizada porque foi aberta somente leitura.

JET_errSessionSharingViolation

Vários threads tentaram usar a mesma sessão de banco de dados.

JET_errTransReadOnly

A transação foi aberta como uma transação somente leitura.

Comentários

Quando bem-sucedido, o índice é excluído e, portanto, não pode ser usado posteriormente. Não deve haver nenhuma transação ativa usando o índice.

Com êxito, a moeda é definida antes do primeiro recorde.

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 JetDeleteIndexW (Unicode) e JetDeleteIndexA (ANSI).

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCreateIndex
JetCreateIndex2