Função JetResetTableSequential

Aplica-se a: Windows | Servidor Windows

Função JetResetTableSequential

A função JetResetTableSequential notifica o mecanismo de banco de dados de que o aplicativo não está mais verificando todo o índice atual que contém um determinado cursor. Essa chamada reverte uma notificação enviada por JetSetTableSequential.

Windows XP:JetResetTableSequential é introduzido em Windows XP.

    JET_ERR JET_API JetResetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

Parâmetros

sesid

A sessão a ser usada para essa chamada.

Tableid

O cursor a ser usado para essa chamada.

grbit

Reservado para uso futuro.

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

Não é possível concluir a operação porque toda a atividade na instância associada à sessão foi interrompida como resultado de uma chamada para JetStopService.

JET_errInstanceUnavailable

Não é possível concluir a operação porque a instância associada à sessão encontrou um erro fatal que exige que o acesso a todos os dados seja revogado para proteger a integridade desses dados. Esse erro só será retornado por Windows XP e versões posteriores.

JET_errNotInitialized

Não é possível concluir a operação porque a instância associada à sessão ainda não foi inicializada.

JET_errRestoreInProgress

Não é possível concluir a operação porque uma operação de restauração está em andamento na instância associada à sessão.

JET_errTermInProgress

Não é possível concluir a operação porque a instância associada à sessão está sendo desligada.

Com êxito, o índice atual do cursor não é mais otimizado para uma verificação sequencial de todo o índice. Nenhuma alteração no estado do banco de dados ocorrerá.

Em caso de falha, nenhuma alteração na configuração do cursor ocorrerá. Nenhuma alteração no estado do banco de dados ocorrerá.

Comentários

É seguro fazer essa chamada em um cursor que não tenha sido configurado anteriormente por uma chamada para JetSetTableSequential.

Requisitos

Requisito Valor

Cliente

Requer Windows Vista ou Windows XP.

Servidor

Requer Windows Server 2008 ou Windows Server 2003.

Cabeçalho

Declarado em Esent.h.

Biblioteca

Use ESENT.lib.

DLL

Requer ESENT.dll.

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService