Función GetRestrictedErrorInfo (roerrorapi.h)

Obtiene el objeto de información de error restringido establecido por una llamada anterior a SetRestrictedErrorInfo en el subproceso lógico actual.

Syntax

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

Parámetros

[out] ppRestrictedErrorInfo

Objeto de información de error restringido asociado al subproceso actual.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código de retorno	Description
S_OK	El objeto de error restringido se recuperó correctamente.
S_FALSE	No hay ningún objeto de error restringido asociado al subproceso actual. Cualquier otro objeto de error se quita del subproceso.

Observaciones

Llame a la función GetRestrictedErrorInfo para obtener el objeto IRestrictedErrorInfo establecido más recientemente en el subproceso actual en una aplicación de la Tienda Windows.

Llame a la función RoCaptureErrorContext para guardar la información de error del subproceso actual. Llame a la función RoFailFastWithErrorContext para generar una excepción, finalizar el proceso actual e informar del error al servicio Windows Error Reporting (WER).

GetRestrictedErrorInfo transfiere la propiedad del objeto de error al autor de la llamada y borra el estado de error del subproceso. Si el objeto de error establecido más recientemente no admite la interfaz IRestrictedErrorInfo , se borra el estado de error del subproceso, pero no se devuelve ninguna interfaz al autor de la llamada.

GetRestrictedErrorInfo recupera el objeto de error del subproceso actual y llama a QueryInterface para encontrar la interfaz IRestrictedErrorInfo. Si no se encuentra IRestrictedErrorInfo , GetRestrictedErrorInfo devuelve S_FALSE. En este caso, el objeto de error se quita del subproceso. Para obtener más información, consulta GetErrorInfo.

Se produce un error al llamar a la función GetRestrictedErrorInfo si IRestrictedErrorInfo no es la implementación del sistema. Para crear un objeto IRestrictedErrorInfo , llame a las funciones OriginError, TransformError o RoCaptureErrorContext .

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
Header	roerrorapi.h
Library	RuntimeObject.lib
DLL de	Combase.dll

Consulte también

GetErrorInfo

IRestrictedErrorInfo

RO_ERROR_REPORTING_FLAGS

roCaptureErrorContext

RoFailFastWithErrorContext

SetRestrictedErrorInfo