Método IVssProviderCreateSnapshotSet::CommitSnapshots (vsprov.h)
O método CommitSnapshots confirma rapidamente todos os LUNs nesse provedor.
Sintaxe
HRESULT CommitSnapshots(
[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 |
|---|---|
|
A operação foi concluída com êxito. |
|
Sem memória ou outros recursos do sistema. |
|
Um dos valores de parâmetro não é válido. |
|
O parâmetro SnapshotSetId refere-se a um objeto que não foi encontrado. |
|
Ocorreu um erro inesperado do provedor. O provedor deve registrar os detalhes desse erro no log de eventos do aplicativo. |
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 é chamado no momento definido em que as cópias de sombra devem ser tiradas. Para cada LUN preparado neste conjunto de cópias de sombra, o provedor executará o trabalho necessário para persistir o conteúdo LUN pontual. Enquanto esse método está sendo executado, os aplicativos e o subsistema de E/S são em grande parte quiescentes. O provedor deve minimizar o tempo gasto nesse método. Como regra geral, esse método deve levar menos de um segundo para ser concluído. Esse método é chamado durante a janela Liberar e Manter e o Suporte ao Kernel do VSS cancelará a liberação e a retenção se a versão não for recebida dentro de 10 segundos, o que faria com que o VSS falhasse no processo de criação da cópia de sombra. Se cada provedor levar mais de um segundo ou dois para concluir essa chamada, há uma alta probabilidade de que toda a criação de cópia de sombra falhe.
Como o sistema de E/S é quiescente, o provedor deve tomar cuidado para não iniciar nenhuma E/S, pois ele poderia colocar o sistema em deadlock – por exemplo, depurar ou rastrear E/S por esse método ou quaisquer chamadas feitas a partir desse método. Os arquivos mapeados em memória e a E/S de paginação não serão congelados no momento.
Observe que o sistema de E/S é quiescente somente enquanto esse método está em execução. Imediatamente após o retorno do método CommitSnapshots do último provedor, o serviço VSS libera todas as gravações pendentes nos LUNs de origem. Se o provedor executar qualquer sincronização dos LUNs de cópia de origem e sombra, essa sincronização deverá ser concluída antes que o método CommitSnapshots do provedor retorne; ele não pode ser executado de forma assíncrona.
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 |