Compartilhar via

Função JetOSSnapshotTruncateLog

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetOSSnapshotTruncateLog

A função JetOSSnapshotTruncateLog habilita o truncamento de log para todas as instâncias que fazem parte da sessão instantâneo.

Windows Vista:JetOSSnapshotTruncateLog é introduzido no Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

Parâmetros

snapId

O identificador da sessão instantâneo.

grbit

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

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 é feita após o tempo limite da sessão instantâneo

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

Em caso de êxito, os arquivos de log de uma ou todas as instâncias da sessão instantâneo 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 teria terminado após a chamada 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