RoOriginateErrorW 함수(roerrorapi.h)

연결된 디버거에 오류 및 정보 문자열을 보고합니다.

구문

BOOL RoOriginateErrorW(
  [in] HRESULT error,
  [in] UINT    cchMax,
  [in] PCWSTR  message
);

매개 변수

[in] error

형식: HRESULT

오류 조건과 연결된 오류 코드입니다. 오류가S_OK 같은 성공 코드인 경우 함수는 효과가 없으며 FALSE를 반환합니다. 이 동작을 사용하면 원치 않는 오류 메시지를 발생하지 않고 오류가 발생하지 않은 경우 함수를 호출할 수 있습니다.

[in] cchMax

형식: UINT

종료되는 NUL 문자를 제외한 메시지의 최대 문자 수입니다. 값이 0이면 문자열은 첫 번째 NUL 문자 또는 512자 중 더 적은 문자로 읽습니다. cchMax가 512보다 크면 512 이후의 모든 문자는 무시됩니다.

[in] message

형식: PCWSTR

개발자가 보고된 오류 조건을 수정하는 데 도움이 되는 정보 문자열입니다. 최대 길이는 후행 NUL 문자를 포함하여 512자입니다. 긴 문자열이 잘립니다.

문자열이 비어 있으면 함수는 성공하지만 오류 정보는 보고되지 않습니다. 항상 정보 문자열을 제공하는 것이 좋습니다.

메시지가NULL이면 함수가 성공하고 사용 가능한 경우 Winerror.h의 제네릭 문자열 또는 E_FAIL 연결된 제네릭 문자열을 보고합니다.

이 함수는 포함된 NUL 문자를 지원하지 않으므로 첫 번째 NUL 이전의 문자만 보고됩니다.

메시지 문자열을 지역화해야 합니다.

반환 값

형식: BOOL

반환 코드 설명
TRUE
오류 메시지가 성공적으로 보고되었습니다.
FALSE
메시지는NULL 이거나 빈 문자열을 가리키거나 오류 는 성공 코드입니다.

설명

RoOriginateErrorW 함수를 사용하여 오류 조건 및 해당 메시지를 디버거에 보고합니다. 이 함수는 로깅 또는 이벤트 추적을 수행하지 않습니다.

구조적 예외를 발생시켜 오류가 디버거에 전달됩니다. 이 예외는 연결된 디버거에 의해 catch되며 예외 매개 변수에는 오류와 메시지 문자열이 모두 포함됩니다. 디버거는 이러한 매개 변수를 사용자에게 표시할 수 있습니다.

디버거의 현재 구성에 따라 RoOriginateErrorW 함수로 인해 예외 사이트의 디버거에서 실행이 중지될 수 있습니다.

UseSetErrorInfo 플래그가 RoSetErrorReportingFlags 함수를 호출하여 설정되고 호출 스레드가 COM에서 초기화된 경우 함수는 IRestrictedErrorInfo를 지원하는 적절한 오류 개체를 만들고 SetErrorInfo를 호출하여 COM 채널에 연결합니다. 스레드가 COM으로 초기화되지 않은 경우 호출은 오류 없이 계속 성공하지만 오류는 COM 채널과 연결되지 않습니다.

참고이는 RoOriginateErrorW 함수의 ANSI 버전이 아닙니다. 메시지 문자열은 유니코드여야 합니다.
 

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 roerrorapi.h
라이브러리 RuntimeObject.lib

추가 정보

RO_ERROR_REPORTING_FLAGS

RoGetErrorReportingFlags

RoOriginateError

RoSetErrorReportingFlags

RoTransformErrorW