Método IVssComponent::GetPreRestoreFailureMsg (vswriter.h)

El método GetPreRestoreFailureMsg recupera el mensaje de error generado por un escritor mientras controla el evento PreRestore , si IVssComponent::SetPreRestoreFailureMsg establece uno.

Un escritor o un solicitante pueden llamar a este método.

Sintaxis

HRESULT GetPreRestoreFailureMsg(
  [out] BSTR *pbstrPreRestoreFailureMsg
);

Parámetros

[out] pbstrPreRestoreFailureMsg

Cadena que contiene el mensaje de error que describe un error que se produjo al procesar el evento PreRestore .

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Value Significado
S_OK
Devolvió correctamente el valor del atributo.
S_FALSE
No había ningún mensaje de error de PreRestore disponible para recuperar.
E_INVALIDARG
Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS.

Comentarios

El llamador debe liberar la memoria que mantiene el parámetro pbstrPreRestoreFailureMsg llamando a SysFreeString.

Si SetPreRestoreFailureMsg no se usó para establecer un mensaje de error de PreRestore , GetPreRestoreFailureMsg devuelve S_FALSE.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vswriter.h (incluya Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssComponent

IVssComponent::GetPostRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg