Compartilhar via

Função JetGrowDatabase

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetGrowDatabase

A função JetGrowDatabase estende o tamanho de um banco de dados que está aberto no momento.

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

Parâmetros

sesid

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

dbid

O banco de dados que será estendido.

Cpg

O tamanho desejado do banco de dados, em páginas.

pcpgReal

Ponteiro para um número que recebe o tamanho do banco de dados, em páginas, após a chamada à API. Se a chamada à API falhar, o conteúdo do pcpgReal será indefinido.

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_errDiskFull

Não há espaço livre suficiente no volume para executar a operação de crescimento.

JET_errDiskIO

Um erro relacionado ao arquivo foi retornado por JetSetDatabaseSize. Para obter mais informações sobre outros erros relacionados a arquivos que podem ser retornados, consulte JetSetDatabaseSize.

Comentários

Se JetGrowDatabase for chamado antes de inserir grandes quantidades de dados, o arquivo de banco de dados será cultivado em uma única operação. Isso reduzirá a probabilidade de o arquivo de banco de dados ficar fragmentado no nível do sistema de arquivos e também reduzirá o número de vezes que o arquivo de banco de dados deve ser aumentado. O crescimento do arquivo de banco de dados uma vez pode ser mais rápido do que o crescimento dele várias vezes.

Atualmente, há suporte apenas para o aumento do arquivo. Para reduzir um arquivo, use o recurso de desfragmentação do programa utilitário esentutl.exe .

Para definir o tamanho de um banco de dados que não está aberto, consulte JetSetDatabaseSize.

O tamanho do arquivo pode não corresponder ao número de páginas retornadas no pcpgReal. Há duas páginas reservadas adicionais que podem não ser contadas no pcpgReal.

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_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize