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

O método GetPostRestoreFailureMsg retorna a mensagem de falha gerada por um gravador durante a manipulação do evento PostRestore , se IVssComponent::SetPostRestoreFailureMsg definir um.

Um gravador ou um solicitante pode chamar esse método.

Sintaxe

HRESULT GetPostRestoreFailureMsg(
  [out] BSTR *pbstrPostRestoreFailureMsg
);

Parâmetros

[out] pbstrPostRestoreFailureMsg

Ponteiro para uma cadeia de caracteres que contém a mensagem de falha que descreve um erro que ocorreu durante o processamento do evento PostRestore .

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor	Significado
S_OK	Retornou com êxito o valor do atributo.
S_FALSE	Nenhuma mensagem PostRestoreFailure estava disponível para recuperação.
E_INVALIDARG	Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY	O chamador está sem memória ou outros recursos do sistema.
VSS_E_INVALID_XML_DOCUMENT	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 em VSS.

Comentários

O chamador deve liberar a memória mantida pelo parâmetro pbstrPostRestoreFailureMsg chamando SysFreeString.

Se SetPostRestoreFailureMsg não foi usado para definir uma mensagem de falha do PostRestore , GetPreRestoreFailureMsg retornará S_FALSE.

Requisitos

Requisito	Valor
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