Função GetRestrictedErrorInfo (roerrorapi.h)

Obtém o objeto de informações de erro restrito definido por uma chamada anterior para SetRestrictedErrorInfo no thread lógico atual.

Sintaxe

HRESULT GetRestrictedErrorInfo(
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

Parâmetros

[out] ppRestrictedErrorInfo

O objeto de informações de erro restrito associado ao thread atual.

Valor de retorno

Essa função pode retornar um desses valores.

Observações

Chame a função GetRestrictedErrorInfo para obter o objeto IRestrictedErrorInfo definido mais recentemente no thread atual em um aplicativo da Windows Store.

Chame a função RoCaptureErrorContext para salvar informações de erro para o thread atual. Chame a função RoFailFastWithErrorContext para gerar uma exceção, encerrar o processo atual e relatar o erro para o SERVIÇO de Relatório de Erros do Windows (WER).

GetRestrictedErrorInfo transfere a propriedade do objeto de erro para o chamador e limpa o estado de erro do thread. Se o objeto de erro definido mais recentemente não der suporte à interface IRestrictedErrorInfo , o estado de erro do thread será limpo, mas nenhuma interface será retornada ao chamador.

O GetRestrictedErrorInfo recupera o objeto de erro do thread atual e chama QueryInterface para localizar a interface IRestrictedErrorInfo . Se IRestrictedErrorInfo não for encontrado, GetRestrictedErrorInfo retornará S_FALSE. Nesse caso, o objeto de erro é removido do thread. Para obter mais informações, consulte GetErrorInfo.

A chamada à função GetRestrictedErrorInfo falhará se IRestrictedErrorInfo não for a implementação do sistema. Para criar um objeto IRestrictedErrorInfo , chame as funções OriginateError, TransformError ou RoCaptureErrorContext .

Requirements

Consulte também

GetErrorInfo

IRestrictedErrorInfo

RO_ERROR_REPORTING_FLAGS

RoCaptureErrorContext

RoFailFastWithErrorContext

SetRestrictedErrorInfo