Método IVssBackupComponentsEx3::GetWriterStatusEx (vsbackup.h)
Devuelve información de estado extendida para el escritor especificado.
Sintaxis
HRESULT GetWriterStatusEx(
[in] UINT iWriter,
[out] VSS_ID *pidInstance,
[out] VSS_ID *pidWriter,
[out] BSTR *pbstrWriter,
[out] VSS_WRITER_STATE *pnStatus,
[out] HRESULT *phrFailureWriter,
[out, optional] HRESULT *phrApplication,
[out, optional] BSTR *pbstrApplicationMessage
);
Parámetros
[in] iWriter
Índice del escritor cuyos metadatos se van a recuperar. El valor de este parámetro es un entero comprendido entre 0 y n-1, donde n es el número total de escritores del sistema actual. El valor de n lo devuelve el método IVssBackupComponents::GetWriterStatusCount .
[out] pidInstance
Dirección de una variable asignada por el autor de la llamada que recibe el identificador de instancia del escritor. Este parámetro es obligatorio y no puede ser NULL.
[out] pidWriter
Dirección de una variable asignada por el autor de la llamada que recibe el identificador de la clase writer. Este parámetro es obligatorio y no puede ser NULL.
[out] pbstrWriter
Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene el nombre del escritor especificado. Este parámetro es obligatorio y no puede ser NULL.
[out] pnStatus
Dirección de una variable asignada por el autor de la llamada que recibe un valor de enumeración VSS_WRITER_STATE . Este parámetro es obligatorio y no puede ser NULL.
[out] phrFailureWriter
Dirección de una variable asignada por el autor de la llamada que recibe el código de error HRESULT que el escritor devolvió para el parámetro hrWriter del método CVssWriterEx2::SetWriterFailureEx .
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. |
|
El escritor notifica uno o varios errores de nivel de componente. Para recuperar los errores, el solicitante debe usar el método IVssComponentEx2::GetFailure . |
[out, optional] 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 CVssWriterEx2::SetWriterFailureEx . Este parámetro es opcional y puede ser NULL.
[out, optional] pbstrApplicationMessage
Dirección de una variable que recibe el mensaje de error de la aplicación que el escritor pasó para el parámetro wszApplicationMessage del método SetWriterFailureEx . Este parámetro es opcional y 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 pnStatus, pidWriter, pbstrWriter o pidInstance 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. |
|
El parámetro iWriter especifica un escritor que no existe. |
Comentarios
Un solicitante debe llamar a la operación asincrónica IVssBackupComponents::GatherWriterStatus y esperar a que se complete antes de llamar a IVssBackupComponentsEx3::GetWriterStatusEx.
Si este método devuelve VSS_E_WRITERERROR_PARTIAL_FAILURE, el solicitante debe usar el método IVssComponentEx2::GetFailure para recuperar los errores de nivel de componente.
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 mantenida por los parámetros pbstrWriter y 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 | vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h) |
Consulte también
CVssWriterEx2::SetWriterFailureEx
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de