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
S_OK	El escritor se realizó correctamente.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	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.
VSS_E_WRITERERROR_OUTOFRESOURCES	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.
VSS_E_WRITERERROR_TIMEOUT	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.
VSS_E_WRITERERROR_RETRYABLE	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.
VSS_E_WRITERERROR_NONRETRYABLE	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

Consulte también

IVssComponentEx2