Função JetCloseFileInstance

Aplica-se a: Windows | Windows Server

Função JetCloseFileInstance

A função JetCloseFileInstance fecha um arquivo que foi aberto com JetOpenFileInstance depois que os dados desse arquivo foram extraídos usando JetReadFileInstance.

Windows XP: JetCloseFileInstance é introduzido no Windows XP.

    JET_ERR JET_API JetCloseFileInstance(
      __in          JET_INSTANCE instance,
      __in          JET_HANDLE hfFile
    );

Parâmetros

instance

A instância a ser usada para essa chamada.

Para o Windows 2000, a variante de API que aceita esse parâmetro não está disponível porque há suporte apenas para uma instância. O uso dessa instância global está implícito nesse caso.

Para o Windows XP e versões posteriores, a variante de API que não aceita esse parâmetro só pode ser chamada quando o mecanismo está no modo herdado (modo de compatibilidade do Windows 2000) em que há suporte apenas para uma instância. Caso contrário, a operação falhará com JET_errRunningInMultiInstanceMode.

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 JetStopServiceInstance.
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 a combinação de vários valores de parâmetro gerava um resultado inesperado. Isso pode acontecer para JetCloseFileInstance 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 de JetOpenFileInstance por vez. Se um identificador de arquivo for aberto usando JetOpenFileInstance , ele deverá ser fechado usando JetCloseFileInstance antes que outro arquivo possa ser aberto.

Requisitos

Requisito	Valor
Cliente	Requer o Windows Vista ou o Windows XP.
Servidor	Requer o Windows Server 2008 ou o Windows Server 2003.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.

Consulte Também

JET_ERR
JET_HANDLE
JET_INSTANCE
JetOpenFileInstance
JetReadFileInstance
JetStopServiceInstance