Compartilhar via


Função RoCaptureErrorContext (roerrorapi.h)

Salva o contexto de erro atual para que ele esteja disponível para chamadas posteriores para a função RoFailFastWithErrorContext .

Sintaxe

HRESULT RoCaptureErrorContext(
  HRESULT hr
);

Parâmetros

hr

O HRESULT associado ao erro.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A função RoCaptureErrorContext captura o contexto associado a um erro, incluindo o stack-backtrace. Essas informações são armazenadas no objeto de erro restrito e estão disponíveis para o serviço wer (Relatório de Erros do Windows), se o WER estiver habilitado e se uma chamada subsequente for feita para a função RoFailFastWithErrorContext do mesmo thread.

Para usar a função RoCaptureErrorContext com RoOriginateError, chame RoOriginateError primeiro e, em seguida, chame RoCaptureErrorContext. Chamar na ordem inversa pode fazer com que o contexto de erro seja perdido.

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
Biblioteca RuntimeObject.lib
DLL ComBase.dll

Confira também

IRestrictedErrorInfo

RoFailFastWithErrorContext

RoOriginateError

RoOriginateErrorW