Função JetOSSnapshotEnd

Aplica-se a: Windows | Windows Server

Função JetOSSnapshotEnd

A função JetOSSnapshotEnd notifica o mecanismo de que a sessão instantâneo concluída.

Windows Vista:JetOSSnapshotEnd é introduzido no Windows Vista:.

    JET_ERR JET_API JetOSSnapshotEnd(
      __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
0	O fim bem-sucedido da sessão instantâneo.
JET_bitAbortSnapshot	A sessão instantâneo anulada.

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	Uma das opções solicitadas é inválida, usada incorretamente ou não implementada.
JET_errOSSnapshotInvalidSequence	Uma sessão instantâneo já está em andamento. Isso não é permitido.
JET_errOSSnapshotInvalidSnapId	O identificador da sessão instantâneo não é válido.
JET_errOSSnapshotTimeOut	A sessão instantâneo tinha um tempo limite interno antes da chamada ocorrer. Como resultado, as operações de E/S retornaram ao normal antes da chamada ser feita.

Se essa função for bem-sucedida, uma sessão de instantâneo será concluída e o comportamento normal do mecanismo será retomado. Uma nova sessão de instantâneo pode ser iniciada posteriormente.

Se essa função falhar, o código de retorno JET_errOSSnapshotTimeOut retornará e a sessão de instantâneo atual terminará, mas o congelamento de E/Ss durante o período de instantâneo não foi respeitado internamente. Para todos os outros erros, o estado da sessão instantâneo não será alterado.

Comentários

Essa função será chamada somente se JetOSSnapshotThaw tiver sido chamado com JET_bitContinueAfterThaw.

A sessão de instantâneo deve ser concluída para que a verificação de instantâneo e o truncamento de log ocorram. As entradas do log de eventos serão geradas para as diferentes etapas do instantâneo.

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
JetOSSnapshotThaw