Método IVssComponentEx2::SetFailure (vswriter.h)
Los escritores de VSS llaman a este método para notificar errores en el nivel de componente.
Sintaxis
HRESULT SetFailure(
[in] HRESULT hr,
[in] HRESULT hrApplication,
[in] LPCWSTR wszApplicationMessage,
[in] DWORD dwReserved
);
Parámetros
[in] hr
Código de error que se va a devolver al solicitante que llama al método IVssComponentEx2::GetFailure .
A continuación se muestran los códigos de error que puede establecer este método.
| Value | Significado |
|---|---|
|
El escritor se realizó correctamente. |
|
La instantánea contiene solo un subconjunto de los volúmenes necesarios para que el escritor realice correctamente una copia de seguridad del componente de la aplicación. |
|
El escritor se quedó sin memoria u otros recursos del sistema. La manera recomendada de controlar este código de error es esperar diez minutos y, a continuación, repetir la operación, hasta tres veces. |
|
Error en la operación de escritura debido a un tiempo de espera entre los eventos Freeze y Thaw. La manera recomendada de controlar este código de error es esperar diez minutos y, a continuación, repetir la operación, hasta tres veces. |
|
Error en el sistema de escritura debido a un error que probablemente no se produciría si se reiniciara todo el proceso de creación de copias de seguridad, restauración o instantánea. La manera recomendada de controlar este código de error es esperar diez minutos y, a continuación, repetir la operación, hasta tres veces. |
|
Error en la operación de escritura debido a un error que podría repetirse si se crea otra instantánea. Para obtener más información, consulte Control de eventos y errores en VSS. |
[in] hrApplication
Código de error adicional que se va a devolver al solicitante. Este parámetro es opcional.
[in] wszApplicationMessage
Cadena que contiene un mensaje de error para que el solicitante se muestre al usuario final. El escritor es responsable de localizar esta cadena si es necesario antes de usarla en este método. Este parámetro es opcional y puede ser NULL o una cadena vacía.
[in] dwReserved
Este parámetro está reservado para uso futuro y debe establecerse en cero.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Además de llamar a este método, use el método CVssWriterEx2::SetWriterFailureEx para notificar que se ha producido un error de escritura parcial.
No se puede llamar a este método desde CVssWriter::OnIdentify o CVssWriterEx::OnIdentifyEx.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vswriter.h |