Método IVssComponentEx2::GetFailure (vswriter.h)

Os solicitantes do VSS chamam esse método para recuperar erros de nível de componente relatados por gravadores.

Sintaxe

HRESULT GetFailure(
  [out] HRESULT *phr,
  [out] HRESULT *phrApplication,
  [out] BSTR    *pbstrApplicationMessage,
  [out] DWORD   *pdwReserved
);

Parâmetros

[out] phr

O endereço de uma variável alocada pelo chamador que recebe o código de falha HRESULT que o gravador passou para o parâmetro hr do método IVssComponentEx2::SetFailure . Esse parâmetro é necessário e não pode ser NULL.

Veja a seguir os valores com suporte.

Valor	Significado
S_OK	O escritor foi bem sucedido.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	A cópia de sombra contém apenas um subconjunto dos volumes necessários para o gravador fazer backup correto do componente do aplicativo.
VSS_E_WRITERERROR_OUTOFRESOURCES	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.
VSS_E_WRITERERROR_TIMEOUT	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.
VSS_E_WRITERERROR_RETRYABLE	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.
VSS_E_WRITERERROR_NONRETRYABLE	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.
VSS_E_WRITER_NOT_RESPONDING	O escritor não está respondendo.
VSS_E_WRITER_STATUS_NOT_AVAILABLE	O gravador status não está disponível para um ou mais escritores. Um gravador pode ter atingido o número máximo de sessões de backup e restauração disponíveis.

[out] phrApplication

O endereço de uma variável alocada pelo chamador que recebe o código de retorno que o gravador passou para o parâmetro hrApplication do método SetFailure . Esse parâmetro é necessário e não pode ser NULL.

[out] pbstrApplicationMessage

O endereço de uma variável alocada pelo chamador que recebe a mensagem de falha do aplicativo que o gravador passou para o parâmetro wszApplicationMessage do método SetFailure . Esse parâmetro é necessário e não pode ser NULL.

[out] pdwReserved

O endereço de uma variável DWORD alocada pelo chamador. Esse parâmetro é reservado para uso futuro, mas é necessário e não pode ser NULL.

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor	Significado
S_OK 0x00000000L	Retornou com êxito o status do gravador especificado. Observe que o valor do parâmetro phrFailureWriter deve ser verificado para verificar se o gravador foi bem-sucedido. Os códigos de falha do gravador podem estar entre os listados em VsWriter.h e em Erros e Vetos do Gravador.
E_INVALIDARG 0x80070057L	O parâmetro phr, phrApplication, pbstrApplicationMessage ou pdwReserved é NULL.
E_OUTOFMEMORY 0x8007000EL	O chamador está sem memória ou outros recursos do sistema.
VSS_E_BAD_STATE 0x80042301L	O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta.

Comentários

Quando o chamador terminar de acessar as informações de status retornadas por esse método, ele deverá chamar SysFreeString para liberar a memória mantida pelo parâmetro pbstrApplicationMessage.

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

Confira também

IVssComponentEx2