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.
Retornar valor
Essa função pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O objeto de erro restrito foi recuperado com êxito. |
|
Não há nenhum objeto de erro restrito associado ao thread atual. Qualquer outro objeto de erro é removido do thread. |
Comentários
Chame a função GetRestrictedErrorInfo para obter o objeto IRestrictedErrorInfo mais recentemente definido 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 ao WER (serviço de Relatório de Erros do Windows).
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 da 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 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | roerrorapi.h |
| DLL | Combase.dll |