WsSetFaultErrorDetail 함수(webservices.h)

WS_ERROR 개체에 저장된 오류 세부 정보를 작성합니다.

구문

HRESULT WsSetFaultErrorDetail(
  [in] WS_ERROR                          *error,
  [in] const WS_FAULT_DETAIL_DESCRIPTION *faultDetailDescription,
  [in] WS_WRITE_OPTION                   writeOption,
       const void                        *value,
  [in] ULONG                             valueSize
);

매개 변수

[in] error

오류 정보를 포함할 오류 개체입니다.

[in] faultDetailDescription

오류 세부 정보 설명에 대한 포인터입니다.

오류 세부 정보 설명의 작업 필드가 NULL이 아닌 경우 WS_ERROR WS_FAULT_ERROR_PROPERTY_ACTION 설정됩니다.

오류 세부 정보 설명의 요소 설명은 오류 세부 정보에서 요소의 형식을 설명합니다.

[in] writeOption

값이 할당되는 방법에 대한 정보입니다. 자세한 내용은 WS_WRITE_OPTION 참조하세요.

value

serialize할 값에 대한 포인터입니다.

[in] valueSize

serialize되는 값의 크기(바이트)입니다.

값이 NULL이면 크기는 0이어야 합니다.

반환 값

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

반환 코드	설명
WS_E_INVALID_FORMAT	입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY	메모리가 부족합니다.

설명

이 API는 WS_ERROR 개체에 저장된 WS_FAULT 세부 정보 필드의 값을 직렬화합니다.

이 함수는 제공된 WS_FAULT_DETAIL_DESCRIPTION WS_ELEMENT_DESCRIPTION 내용에 따라 다음 시나리오를 지원합니다.

• 단일 요소를 작성합니다. 이 경우 WS_ELEMENT_DESCRIPTION elementLocalName 및 elementNs 필드를 작성할 요소의 로컬 이름 및 네임스페이스로 설정해야 하며 형식 및 형식 설명은 serialize되는 값의 형식을 나타냅니다.
• 여러 요소를 단일 값으로 작성합니다. 이 경우 WS_ELEMENT_DESCRIPTION elementLocalName 및 elementNs 필드를 NULL로 설정하고 WS_STRUCT_TYPE 및 WS_STRUCT_DESCRIPTION 지정해야 합니다. serialize되는 구조체 값의 각 필드는 오류 세부 정보 내에서 작성할 요소에 해당해야 합니다. writeOption 매개 변수는 WS_WRITE_REQUIRED_VALUE 또는 WS_WRITE_REQUIRED_POINTER 합니다.

요구 사항

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