Método IVssHardwareSnapshotProvider::OnLunEmpty (vsprov.h)
O método OnLunEmpty é chamado sempre que o VSS determina que um LUN de cópia de sombra não contém dados interessantes. Todas as cópias de sombra foram excluídas (o que também causa a exclusão do LUN.) Os recursos do LUN podem ser recuperados pelo provedor e reutilizados para outra finalidade. O VSS desmontará todos os volumes afetados. Um provedor não deve emitir uma nova verificação durante OnLunEmpty. O VSS manipulará essa limpeza.
Sintaxe
HRESULT OnLunEmpty(
[in] VSS_PWSZ wszDeviceName,
[in] VDS_LUN_INFORMATION *pInformation
);
Parâmetros
[in] wszDeviceName
Dispositivo correspondente ao LUN que contém a cópia de sombra a ser excluída.
[in] pInformation
Ponteiro para uma estrutura VDS_LUN_INFORMATION que contém informações sobre o LUN que contém a cópia de sombra a ser excluída.
Retornar valor
Esse método pode retornar um desses valores.
| Valor/código retornado | Descrição |
|---|---|
|
A operação foi concluída com êxito. |
|
Memória insuficiente ou outros recursos do sistema. |
|
Um dos valores de parâmetro não é válido. |
|
Ocorreu um erro inesperado do provedor. O provedor deve relatar um evento no log de eventos do aplicativo fornecendo ao usuário informações sobre como resolve o problema. |
Comentários
Os provedores de hardware devem excluir uma cópia de sombra e recuperar o LUN se e somente se
OnLunEmpty está sendo chamado. Uma cópia de sombra de hardware pode ser usada como a própria mídia de backup, portanto, os LUNs devem ser tratados com o mesmo cuidado que a matriz de armazenamento trata LUNs usados para discos regulares. A recuperação de LUNs fora do processamento para OnLunEmpty deve ser limitada a emergências ou a um administrador executando ações explícitas manualmente.
No caso de cópias de sombra persistentes, o solicitante exclui a cópia de sombra quando ela não é mais necessária. No caso de cópias de sombra de liberação automática não persistentes, o serviço VSS exclui a cópia de sombra quando o solicitante chama IUnknown::Release no objeto IVssBackupComponents . No caso de cópias de sombra não persistentes que não são de liberação automática, o serviço VSS exclui a cópia de sombra quando o computador é reiniciado. Em todos os casos, o serviço VSS chama o método OnLunEmpty do provedor conforme necessário para cada LUN de cópia de sombra.
Observe que OnLunEmpty é chamado com base no melhor esforço. O VSS invoca o método somente quando o LUN tem a garantia de estar vazio. Pode haver muitos casos em que o LUN está vazio, mas o VSS não consegue detectar isso devido a erros ou circunstâncias externas. Nesse caso, o usuário deve usar o software de gerenciamento de armazenamento para limpar esse estado.
Alguns exemplos:
- Quando um LUN de cópia de sombra é movido para um host diferente, mas não realmente transportado ou importado por meio do VSS, esse LUN aparece como qualquer outro LUN, e os volumes podem ser simplesmente excluídos sem qualquer notificação do VSS.
- Uma falha ou uma reinicialização inesperada no meio de uma criação de cópia de sombra.
- Uma importação cancelada.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vsprov.h |