Compartilhar via

Método IVssProviderCreateSnapshotSet::P reFinalCommitSnapshots (vsprov.h)

  • Artigo

O método PreFinalCommitSnapshots permite que os provedores ofereçam suporte a cópias de sombra de recuperação automática . Se a cópia de sombra tiver o sinalizador VSS_VOLSNAP_ATTR_AUTORECOVER definido no contexto, o volume poderá receber um grande número de gravações durante a operação de recuperação automática.

Sintaxe

HRESULT PreFinalCommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parâmetros

[in] SnapshotSetId

O VSS_ID que identifica o conjunto de cópias de sombra.

Retornar valor

Valor/código retornado Descrição
S_OK
0x00000000L
 A operação foi concluída com êxito.
E_OUTOFMEMORY
0x8007000EL
 Memória insuficiente ou outros recursos do sistema.
E_INVALIDARG
0x80070057L
 Um dos valores de parâmetro não é válido.
VSS_E_PROVIDER_VETO
0x80042306L
 Ocorreu um erro inesperado do provedor. Se isso for retornado, o erro deverá ser descrito em uma entrada no log de eventos do aplicativo, dando ao usuário informações sobre como resolve o problema.
 

Se qualquer outro valor for retornado, o VSS gravará um evento no log de eventos e converterá o erro em VSS_E_UNEXPECTED_PROVIDER_ERROR.

Comentários

Esse método foi adicionado para habilitar a compatibilidade binária quando o recurso de recuperação automática foi introduzido no Windows Server 2003 com Service Pack 1 (SP1).

Nota Para o Windows Server 2003, é recomendável que os provedores de hardware implementem esse método usando o seguinte exemplo:
 
HRESULT PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vsprov.h

Confira também

IVssProviderCreateSnapshotSet