Compartilhar via


Método IVssComponentEx::GetPostSnapshotFailureMsg (vswriter.h)

Retorna a cadeia de caracteres de mensagem de falha PostSnapshot que um gravador definiu para um determinado componente.

Gravadores e solicitantes podem chamar esse método. Os gravadores devem chamar esse método depois que a operação assíncrona IVssBackupComponents::D oSnapshotSet for concluída.

Sintaxe

HRESULT GetPostSnapshotFailureMsg(
  [out] BSTR *pbstrFailureMsg
);

Parâmetros

[out] pbstrFailureMsg

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém a mensagem de falha que descreve um erro que ocorreu durante o processamento de um evento PostSnapshot .

Valor retornado

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

Valor Significado
S_OK
A mensagem de falha foi obtida com êxito.
S_FALSE
Nenhuma mensagem de falha do PostSnapshot foi definida para o componente.
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.

Comentários

O chamador é responsável por liberar a cadeia de caracteres para a qual o parâmetro pbstrFailureMsg aponta chamando a função SysFreeString .

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [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

CVssWriter::OnPostSnapshot

IVssComponentEx

IVssComponentEx::SetPostSnapshotFailureMsg