Função JetResizeDatabase

Aplica-se a: Windows | Windows Server

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

A função JetResizeDatabase foi introduzida no sistema operacional Windows 8.

JET_ERR JET_API JetResizeDatabase(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          unsigned long cpg,
  __out         unsigned long* pcpgActual,
  __in          const JET_GRBIT grbit
);

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 solicitado do banco de dados, em páginas.

pcpgActual

Um 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 parâmetro pcpgActual será indefinido.

grbit

Um grupo de bits que especifica zero ou mais dos valores listados na tabela a seguir.

Valor	Significado
JET_bitResizeDatabaseOnlyGrow	Aumentar apenas o banco de dados. Se a chamada de redimensionamento reduzir o banco de dados, não faça nada.

Valor retornado

Essa função retorna o tipo de dados JET_ERR com um dos códigos de retorno listados na tabela a seguir. Para obter mais informações sobre os possíveis erros do Mecanismo de Armazenamento Extensível (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 pela função JetSetDatabaseSize . Para obter mais informações sobre outros erros relacionados a arquivos que podem ser retornados, consulte JetSetDatabaseSize.

Comentários

Se a função JetResizeDatabase for chamada antes de inserir grandes quantidades de dados, o arquivo de banco de dados será cultivado em uma 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.

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 parâmetro pcpgReal . Duas páginas reservadas adicionais podem não ser contadas no parâmetro pcpgReal .

Requisitos

Requisito	Valor
Cliente	Requer Windows 8.
Servidor	Requer Windows Server 2012.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.

Confira também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize