Método CVssWriterEx2::SetWriterFailureEx (vswriter.h)
Define informações de erro estendidas para indicar que o gravador encontrou um problema ao participar de uma operação vss.
Sintaxe
HRESULT SetWriterFailureEx(
[in] HRESULT hrWriter,
[in] HRESULT hrApplication,
[in] LPCWSTR wszApplicationMessage
);
Parâmetros
[in] hrWriter
O código de erro a ser retornado ao solicitante.
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 para o gravador 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 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 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 backup, restauração ou cópia de sombra fosse reiniciado. A maneira recomendada de lidar com esse código de erro é aguardar dez minutos e 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 no VSS. |
|
O gravador está relatando um ou mais erros no nível do componente. Para relatar os erros, o gravador deve usar o método IVssComponentEx2::SetFailure . |
[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.
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
Esse método não pode ser chamado de CVssWriter::OnIdentify ou CVssWriterEx::OnIdentifyEx.
Para relatar erros no nível do componente, os gravadores devem usar o método IVssComponentEx2::SetFailure .
Se o manipulador de eventos de um gravador (como CVssWriter::OnFreeze) chamar esse método, ele deverá fazer isso no mesmo thread que chamou o manipulador de eventos. Para obter mais informações, consulte Tratamento de eventos do gravador.
Requisitos
| Requisito | Valor |
|---|---|
| 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 (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |