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 |
|---|---|
|
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 escritor não está respondendo. |
|
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 |
|---|---|
|
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. |
|
O parâmetro phr, phrApplication, pbstrApplicationMessage ou pdwReserved é NULL. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 |