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 |
---|---|
|
Retornou com êxito o valor do atributo. |
|
Nenhuma mensagem PostRestoreFailure estava disponível para recuperação. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 |
Confira também
IVssComponent::GetPreRestoreFailureMsg