Método IVssComponentEx2::GetFailure (vswriter.h)
Los solicitantes de VSS llaman a este método para recuperar errores de nivel de componente notificados por escritores.
Sintaxis
HRESULT GetFailure(
[out] HRESULT *phr,
[out] HRESULT *phrApplication,
[out] BSTR *pbstrApplicationMessage,
[out] DWORD *pdwReserved
);
Parámetros
[out] phr
Dirección de una variable asignada por el autor de la llamada que recibe el código de error HRESULT que el escritor pasó para el parámetro hr del método IVssComponentEx2::SetFailure . Este parámetro es obligatorio y no puede ser NULL.
A continuación se muestran los valores admitidos.
| Valor | 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 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. |
|
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. |
|
El escritor no responde. |
|
El estado del escritor no está disponible para uno o varios escritores. Un escritor puede haber alcanzado el número máximo de sesiones de copia de seguridad y restauración disponibles. |
[out] phrApplication
Dirección de una variable asignada por el autor de la llamada que recibe el código de retorno que el escritor pasó para el parámetro hrApplication del método SetFailure . Este parámetro es obligatorio y no puede ser NULL.
[out] pbstrApplicationMessage
Dirección de una variable asignada por el autor de la llamada que recibe el mensaje de error de la aplicación que el escritor pasó para el parámetro wszApplicationMessage del método SetFailure . Este parámetro es obligatorio y no puede ser NULL.
[out] pdwReserved
Dirección de una variable DWORD asignada por el autor de la llamada. Este parámetro está reservado para uso futuro, pero es necesario y no puede ser NULL.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se devolvió correctamente el estado del escritor especificado. Tenga en cuenta que el valor del parámetro phrFailureWriter debe comprobarse para comprobar que el sistema de escritura se realizó correctamente. Los códigos de error del sistema de escritura pueden estar entre los enumerados en VsWriter.h y en Errores y Vetas de escritor. |
|
El parámetro phr, phrApplication, pbstrApplicationMessage o pdwReserved es NULL. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta. |
Comentarios
Cuando el autor de la llamada ha terminado de obtener acceso a la información de estado devuelta por este método, debe llamar a SysFreeString para liberar la memoria que mantiene el parámetro pbstrApplicationMessage .
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 |