WsCreateFaultFromError 함수(webservices.h)

지정된 오류 개체에서 WS_FAULT 생성합니다.

구문

HRESULT WsCreateFaultFromError(
  [in]  WS_ERROR            *error,
  [in]  HRESULT             faultErrorCode,
  [in]  WS_FAULT_DISCLOSURE faultDisclosure,
  [in]  WS_HEAP             *heap,
  [out] WS_FAULT            *fault
);

매개 변수

[in] error

오류를 생성할 오류 개체를 나타내는 WS_ERROR 구조체에 대한 포인터입니다.

[in] faultErrorCode

실패한 함수에서 반환된 HRESULT 오류 코드입니다. HRESULT 값은 성공 코드일 수 없습니다.

이 오류 코드는 오류에 직접 포함되지 않지만 오류 개체에 오류 문자열이 없는 경우 오류 문자열을 만들기 위한 대체 메커니즘으로 사용됩니다.

[in] faultDisclosure

오류 개체에서 오류 개체로 복사되는 정보를 제어하는 열거형을 WS_FAULT_DISCLOSURE.

[in] heap

반환된 장애 개체에 대한 메모리를 할당할 힙을 나타내는 WS_HEAP 구조체에 대한 포인터입니다.

[out] fault

반환된 오류 개체를 나타내는 WS_FAULT 구조체에 대한 포인터입니다. WsFreeHeap 또는 WsResetHeap이 호출되어 지정된 힙 리소스를 해제할 때까지 장애 개체의 필드는 양호합니다.

반환 값

함수가 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 HRESULT 오류 코드가 반환됩니다.

반환 코드	설명
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 완료할 수 없습니다.
기타 오류	이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

오류 개체에 오류가 포함된 경우(즉, WS_FAULT_ERROR_PROPERTY_ID WS_FAULT_ERROR_PROPERTY_FAULT 값이 NULL이 아닌 경우) 반환된 오류를 생성하기 위해 해당 오류가 선택됩니다.

오류 개체에 오류가 포함되지 않은 경우(WS_FAULT_ERROR_PROPERTY_FAULT NULL임) 반환된 오류를 생성하기 위해 제네릭 오류 코드(및 이유 없는 텍스트)가 있는 제네릭 오류가 선택됩니다.

선택한 오류에 이유 텍스트가 포함되지 않은 경우 오류 이유 텍스트는 공개 매개 변수의 값에 따라 생성됩니다.

• WS_FULL_FAULT_DISCLOSURE 오류 개체에 있는 모든 오류 문자열이 함께 추가되어 이유 텍스트를 형성합니다. 문자열이 없으면 errorCode 매개 변수와 연결된 문자열이 사용됩니다.
• WS_MINIMAL_FAULT_DISCLOSURE 제네릭 오류 문자열이 사용됩니다.

기본적으로 오류 개체의 언어 종속 정보의 언어는 현재 사용자 기본 UI 언어입니다. 그러나 WS_ERROR_PROPERTY_LANGID 속성을 설정하여 언어를 변경할 수 있습니다. WS_ERROR_PROPERTY_ID 열거형을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	webservices.h
라이브러리	WebServices.lib
DLL	WebServices.dll