Método IVssComponentEx2::SetFailure (vswriter.h)
Os gravadores VSS chamam esse método para relatar erros no nível do componente.
Sintaxe
HRESULT SetFailure(
[in] HRESULT hr,
[in] HRESULT hrApplication,
[in] LPCWSTR wszApplicationMessage,
[in] DWORD dwReserved
);
Parâmetros
[in] hr
O código de erro a ser retornado ao solicitante que chama o método IVssComponentEx2::GetFailure .
Veja a seguir os códigos de erro que esse método pode definir.
| Valor | Significado |
|---|---|
|
O escritor foi bem sucedido. |
|
A cópia de sombra contém apenas um subconjunto dos volumes necessários pelo gravador para fazer backup correto do componente do aplicativo. |
|
O gravador ficou sem memória ou outros recursos do sistema. A maneira recomendada de lidar com esse código de erro é aguardar dez minutos e, em seguida, repetir a operação, até três vezes. |
|
A operação de gravador falhou devido a um tempo limite entre os eventos Congelar e Descongelar. A maneira recomendada de lidar com esse código de erro é aguardar dez minutos e, em seguida, repetir a operação, até três vezes. |
|
O gravador falhou devido a um erro que provavelmente não ocorreria se todo o processo de criação de cópia de backup, restauração ou sombra fosse reiniciado. A maneira recomendada de lidar com esse código de erro é aguardar dez minutos e, em seguida, repetir a operação, até três vezes. |
|
A operação de gravador falhou devido a um erro que pode ocorrer novamente se outra cópia de sombra for criada. Para obter mais informações, consulte Tratamento de eventos e erros em VSS. |
[in] hrApplication
Um código de erro adicional a ser retornado ao solicitante. Esse parâmetro é opcional.
[in] wszApplicationMessage
Uma cadeia de caracteres que contém uma mensagem de erro para o solicitante exibir para o usuário final. O gravador é responsável por localizar essa cadeia de caracteres, se necessário, antes de usá-la nesse método. Esse parâmetro é opcional e pode ser NULL ou uma cadeia de caracteres vazia.
[in] dwReserved
Esse parâmetro é reservado para uso futuro e deve ser definido como zero.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Além de chamar esse método, use o método CVssWriterEx2::SetWriterFailureEx para relatar que ocorreu uma falha parcial do gravador.
Esse método não pode ser chamado de CVssWriter::OnIdentify ou CVssWriterEx::OnIdentifyEx.
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h |