Compartilhar via

Função JetOSSnapshotTruncateLogInstance

Aplica-se a: Windows | Windows Server

Função JetOSSnapshotTruncateLogInstance

A função JetOSSnapshotTruncateLogInstance trunca o log de uma instância especificada durante uma sessão de instantâneo.

Windows Vista:JetOSSnapshotTruncateLogInstance é introduzido no Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLogInstance(
      __in          const JET_OSSNAPID snapId,
      __in          JET_INSTANCE instance,
      __in          const JET_GRBIT grbit
    );

Parâmetros

snapId

O identificador da sessão instantâneo.

instance

A instância que será usada para essa chamada.

grbit

As opções para essa chamada. Esse parâmetro pode ter uma combinação dos valores a seguir.

grbit pode ser um dos seguintes valores:

Valor

Significado

JET_bitAllDatabasesSnapshot

Todos os bancos de dados são anexados para que o mecanismo de armazenamento possa calcular e fazer o truncamento de log.

0 (zero)

Nenhum truncamento ocorrerá.

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_errInvalidGrbit

O parâmetro grbit é inválido.

JET_errOSSnapshotInvalidSequence

A sessão instantâneo não está no estado em que um truncamento pode ocorrer. Causas possíveis:

  • A chamada é concluída depois que a sessão de instantâneo atingiu o tempo limite.

  • A sessão foi especificada como uma cópia instantâneo.

Se essa função for bem-sucedida, os arquivos de log de uma ou todas as instâncias que fazem parte do instantâneo sessão serão truncados, se possível.

Comentários

Essa função só deverá ser chamada se o instantâneo tiver sido criado com a opção JET_bitContinueAfterThaw. Caso contrário, a sessão instantâneo terminará após a chamada para JetOSSnapshotThaw.

Requisitos

Requisito Valor

Cliente

Requer o Windows Vista.

Servidor

Requer o Windows Server 2008.

Cabeçalho

Declarado em Esent.h.

Biblioteca

Use ESENT.lib.

DLL

Requer ESENT.dll.

Consulte Também

Parâmetros de tratamento de erro
Erros extensíveis do mecanismo de armazenamento
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw

  • Last updated on