GetRestrictedErrorInfo 함수(roerrorapi.h)

아티클
08/25/2023

현재 논리 스레드에서 SetRestrictedErrorInfo 에 대한 이전 호출에서 설정한 제한된 오류 정보 개체를 가져옵니다.

구문

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

매개 변수

[out] ppRestrictedErrorInfo

현재 스레드와 연결된 제한된 오류 정보 개체입니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	제한된 오류 개체가 성공적으로 검색되었습니다.
S_FALSE	현재 스레드와 연결된 제한된 오류 개체가 없습니다. 다른 오류 개체는 스레드에서 제거됩니다.

설명

GetRestrictedErrorInfo 함수를 호출하여 Windows 스토어 앱의 현재 스레드에서 가장 최근에 설정된 IRestrictedErrorInfo 개체를 가져옵니다.

RoCaptureErrorContext 함수를 호출하여 현재 스레드에 대한 오류 정보를 저장합니다. RoFailFastWithErrorContext 함수를 호출하여 예외를 발생시키고, 현재 프로세스를 종료하고, 오류를 WER(Windows 오류 보고 서비스)에 보고합니다.

GetRestrictedErrorInfo 는 오류 개체의 소유권을 호출자에게 전송하고 스레드의 오류 상태를 지웁니다. 가장 최근에 설정된 오류 개체가 IRestrictedErrorInfo 인터페이스를 지원하지 않는 경우 스레드의 오류 상태는 지워지지만 호출자에게는 인터페이스가 반환되지 않습니다.

GetRestrictedErrorInfo는 현재 스레드에서 오류 개체를 검색하고 QueryInterface를 호출하여 IRestrictedErrorInfo 인터페이스를 찾습니다. IRestrictedErrorInfo를 찾을 수 없는 경우 GetRestrictedErrorInfo는 S_FALSE 반환합니다. 이 경우 오류 개체가 스레드에서 제거됩니다. 자세한 내용은 GetErrorInfo를 참조하세요.

IRestrictedErrorInfo가 시스템 구현이 아닌 경우 GetRestrictedErrorInfo 함수를 호출하지 못합니다. IRestrictedErrorInfo 개체를 만들려면 OriginateError, TransformError 또는 RoCaptureErrorContext 함수를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	roerrorapi.h
DLL	Combase.dll