Compartilhar via


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

Define uma cadeia de caracteres de mensagem de falha PrepareForBackup para um componente.

Esse método só pode ser chamado pelo método CVssWriter::OnPrepareBackup de um gravador.

Sintaxe

HRESULT SetPrepareForBackupFailureMsg(
  [in] LPCWSTR wszFailureMsg
);

Parâmetros

[in] wszFailureMsg

O endereço de uma cadeia de caracteres largos terminada em NULL alocada pelo chamador que contém a mensagem de falha que descreve um erro que ocorreu durante o processamento de um evento PrepareForBackup .

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 definida com êxito.
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_BAD_STATE
Esse método não foi chamado pelo método CVssWriter::OnPrepareBackup de um gravador.

Comentários

A mensagem de falha definida por SetPrepareForBackupFailureMsg aplica-se a todos os arquivos no componente e a todos os subcomponentes.

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::OnPrepareBackup

IVssComponentEx

IVssComponentEx::GetPrepareForBackupFailureMsg