Método CVssWriterEx2::SetWriterFailureEx (vswriter.h)

Establece la información de error extendida para indicar que el escritor ha encontrado un problema con la participación en una operación de VSS.

Sintaxis

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

Parámetros

[in] hrWriter

Código de error que se va a devolver al solicitante.

A continuación se muestran los códigos de error que puede establecer este método.

Valor	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 reiniciaba 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, vea Control de eventos y errores en VSS.
VSS_E_WRITERERROR_PARTIAL_FAILURE	El escritor notifica uno o varios errores de nivel de componente. Para notificar los errores, el escritor debe usar el método IVssComponentEx2::SetFailure .

[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 usarlo en este método. Este parámetro es opcional y puede ser NULL o una cadena vacía.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

No se puede llamar a este método desde CVssWriter::OnIdentify o CVssWriterEx::OnIdentifyEx.

Para notificar errores de nivel de componente, los escritores deben usar el método IVssComponentEx2::SetFailure .

Si el controlador de eventos de un escritor (como CVssWriter::OnFreeze) llama a este método, debe hacerlo en el mismo subproceso que llamó al controlador de eventos. Para obtener más información, vea Writer Event Handling.

Requisitos

Requisito	Value
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 (incluye Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

CVssWriter::SetWriterFailure

CVssWriterEx2

IVssBackupComponentsEx3::GetWriterStatusEx