Compartilhar via


Método CVssWriter::SetWriterFailure (vswriter.h)

O método SetWriterFailure indica que esse gravador encontrou uma condição de erro e define uma condição de erro.

SetWriterFailure é um método protegido implementado pela classe base CVssWriter .

Sintaxe

HRESULT SetWriterFailure(
  [in] HRESULT hr
);

Parâmetros

[in] hr

Código de erro a ser definido. Veja a seguir os códigos de erro que esse método pode definir.

Valor Significado
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
A cópia de sombra contém apenas um subconjunto dos volumes necessários para fazer backup correto de um componente do aplicativo.
VSS_E_WRITERERROR_NONRETRYABLE
O gravador falhou devido a um erro que provavelmente ocorreria se outra cópia de sombra fosse criada.
VSS_E_WRITERERROR_OUTOFRESOURCES
O gravador falhou devido a um erro de alocação de recursos.
VSS_E_WRITERERROR_RETRYABLE
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.
VSS_E_WRITERERROR_TIMEOUT
O gravador não pôde concluir a criação da cópia de sombra porque o tempo entre os estados de congelamento e descongelamento excedeu o valor de tempo limite (dwTimeoutFreeze) definido em CVssWriter::Initialize.

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.

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

   
Cliente mínimo com suporte Windows XP [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 vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

CVssWriter

IVssBackupComponents::GetWriterStatus