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