Función GetRestrictedErrorInfo (roerrorapi.h)

Artículo
08/25/2023

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

Sintaxis

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 devuelto	Descripción
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.

Comentarios

Llama a la función GetRestrictedErrorInfo para obtener el objeto IRestrictedErrorInfo establecido más recientemente en el subproceso actual de 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 de Informe de errores de Windows (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 buscar 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 OriginateError, TransformError o RoCaptureErrorContext .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	roerrorapi.h
Archivo DLL	Combase.dll