Compartilhar via

Função JetCloseFile

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetCloseFile

A função JetCloseFile fecha um arquivo que foi aberto com JetOpenFile depois que os dados desse arquivo foram extraídos usando JetReadFile.

    JET_ERR JET_API JetCloseFile(
      __in          JET_HANDLE hfFile
    );

Parâmetros

hfFile

O identificador do arquivo a ser lido.

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_errClientRequestToStopJetService

Não é possível concluir a operação porque todas as atividades na instância associada à sessão cessaram 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 pelo Windows XP e versões posteriores.

JET_errInvalidParameter

Um dos parâmetros fornecidos continha um valor inesperado ou continha um valor que não fazia sentido quando combinado com o valor de outro parâmetro. Isso pode acontecer para JetCloseFile quando:

  • O identificador de instância especificado é inválido (Windows XP e versões posteriores),

  • O identificador de arquivo especificado é inválido.

JET_errNoBackup

A operação falhou porque nenhum backup externo está em andamento.

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_errRunningInMultiInstanceMode

A operação falhou porque foi feita uma tentativa de usar o mecanismo no modo herdado (modo de compatibilidade do Windows 2000) em que apenas uma instância tem suporte quando, na verdade, várias instâncias já existem.

JET_errTermInProgress

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

Em caso de êxito, o identificador de arquivo é fechado. Se um arquivo de banco de dados tiver sido fechado, o arquivo de patch do banco de dados associado (se houver) será destruído.

Em caso de falha, nenhuma alteração ocorre.

Comentários

Atualmente, o mecanismo de banco de dados dá suporte apenas a um arquivo aberto por meio do JetOpenFile por vez. Se um identificador de arquivo for aberto usando JetOpenFile , ele deverá ser fechado usando JetCloseFile antes que outro arquivo possa ser aberto.

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.

Consulte Também

JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService