Compartilhar via

Função JetOpenDatabase

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetOpenDatabase

A função JetOpenDatabase abre um banco de dados anexado anteriormente, usando as funções JetAttachDatabase ou JetAttachDatabase2 , para uso com uma sessão de banco de dados. Essa função pode ser chamada várias vezes para o mesmo banco de dados.

    JET_ERR JET_API JetOpenDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in_opt      const tchar* szConnect,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

Parâmetros

sesid

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

szFilename

O nome do banco de dados a ser aberto.

szConnect

Reservado. Definido como NULL.

pdbid

Ponteiro para um buffer que, em uma chamada bem-sucedida, contém o identificador do banco de dados. Se a chamada falhar, o valor será indefinido.

grbit

Um grupo de bits que especificam zero ou mais das opções a seguir.

Valor

Significado

JET_bitDbExclusive

Permite que apenas uma única sessão anexe um banco de dados. Normalmente, várias sessões podem abrir um banco de dados.

JET_bitDbReadOnly

Impede modificações no banco de dados.

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_errDatabaseInUse

O acesso exclusivo foi solicitado, mas não pôde ser concedido.

JET_errDatabaseInvalidPath

Um caminho inválido foi fornecido em szFilename. szFilename deve ser não NULL e fazer referência a um arquivo válido.

JET_errDatabaseLocked

Outra sessão já abriu o banco de dados exclusivamente (usando JET_bitDbExclusive).

JET_errDatabaseNotFound

O banco de dados não foi anexado anteriormente (consulte JetAttachDatabase).

JET_errInvalidDatabase

Foi feita uma tentativa de abrir um arquivo que não é um arquivo de banco de dados válido.

JET_errOneDatabasePerSession

Foi feita uma tentativa de abrir mais de um banco de dados e JET_paramOneDatabasePerSession foi definido. Para obter mais informações, consulte Parâmetros do sistema.

JET_wrnFileOpenReadOnly

O arquivo foi anexado como somente leitura, mas JetOpenDatabase não passou JET_bitDbReadOnly. O banco de dados ainda é aberto com acesso somente leitura.

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 JetOpenDatabaseW (Unicode) e JetOpenDatabaseA (ANSI).

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Parâmetros do sistema