Compartilhar via


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

O método SetPostRestoreFailureMsg é usado para criar uma mensagem que descreve uma falha no processamento de um evento PostRestore .

Somente um gravador pode chamar esse método e somente durante uma operação de restauração.

Sintaxe

HRESULT SetPostRestoreFailureMsg(
  [in] LPCWSTR wszPostRestoreFailureMsg
);

Parâmetros

[in] wszPostRestoreFailureMsg

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 PostRestore .

Retornar valor

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

Valor Significado
S_OK
Defina com êxito a mensagem de falha.
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
O chamador não está no estado correto (backup ou restauração) para a operação.

Comentários

A mensagem de falha definida por SetPostRestoreFailureMsg aplica-se a todos os arquivos no componente e a quaisquer subcomponentes não reelecionáveis.

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

Confira também

IVssComponent

IVssComponent::GetPostRestoreFailureMsg

IVssComponent::GetPreRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg