Método IVssComponent::GetPreRestoreFailureMsg (vswriter.h)
O método GetPreRestoreFailureMsg recupera a mensagem de erro gerada por um gravador durante o tratamento do evento PreRestore , se IVssComponent::SetPreRestoreFailureMsg definir um.
Um gravador ou um solicitante pode chamar esse método.
Sintaxe
HRESULT GetPreRestoreFailureMsg(
[out] BSTR *pbstrPreRestoreFailureMsg
);
Parâmetros
[out] pbstrPreRestoreFailureMsg
Cadeia de caracteres que contém a mensagem de falha que descreve um erro que ocorreu durante o processamento do evento PreRestore .
Valor retornado
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
Retornou com êxito o valor do atributo. |
|
Nenhuma mensagem de falha do PreRestore estava disponível para recuperação. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros no VSS. |
Comentários
O chamador deve liberar a memória mantida pelo parâmetro pbstrPreRestoreFailureMsg chamando SysFreeString.
Se SetPreRestoreFailureMsg não tiver sido usado para definir uma mensagem de falha de PreRestore , GetPreRestoreFailureMsg retornará S_FALSE.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |
Confira também
IVssComponent::GetPostRestoreFailureMsg