다음을 통해 공유

WsGetFaultErrorDetail 함수(webservices.h)

  • 아티클

WS_ERROR 개체에 저장된 오류 세부 정보를 읽습니다.

구문

HRESULT WsGetFaultErrorDetail(
  [in]           WS_ERROR                          *error,
  [in]           const WS_FAULT_DETAIL_DESCRIPTION *faultDetailDescription,
  [in]           WS_READ_OPTION                    readOption,
  [in, optional] WS_HEAP                           *heap,
                 void                              *value,
  [in]           ULONG                             valueSize
);

매개 변수

[in] error

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

[in] faultDetailDescription

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

오류 세부 정보 설명의 작업 값은 오류 동작과 일치하는 필터 값으로 사용됩니다. 두 작업 문자열이 모두 지정되면(오류 세부 정보 설명의 작업 값이 NULL이 아니고 WS_ERROR WS_FAULT_ERROR_PROPERTY_ACTION 작업 값의 길이가 0보다 큼) 작업 문자열을 비교하여 일치 항목을 확인합니다. 일치하는 항목이 있는 경우 함수는 detail 요소를 역직렬화하려고 시도합니다.

오류 세부 정보 설명의 요소 설명은 오류 세부 정보에서 요소의 형식을 설명하는 데 사용됩니다.

[in] readOption

요소가 필요한지 여부와 값을 할당하는 방법입니다. 자세한 내용은 WS_READ_OPTION 참조하세요.

[in, optional] heap

역직렬화된 값을 저장할 힙입니다.

value

이 매개 변수의 해석은 WS_READ_OPTION 따라 달라집니다.

[in] valueSize

이 매개 변수의 해석은 WS_READ_OPTION 따라 달라집니다.

반환 값

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

반환 코드 설명
WS_E_INVALID_FORMAT
 입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
WS_E_QUOTA_EXCEEDED
 힙의 크기 할당량을 초과했습니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.

설명

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

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

  • 단일 요소 읽기. 이 경우 WS_ELEMENT_DESCRIPTION elementLocalName 및 elementNs 필드를 읽을 요소의 로컬 이름 및 네임스페이스로 설정해야 하며 형식 및 형식 설명은 역직렬화되는 값의 형식을 나타냅니다.

    서비스에서 서로 다른 세부 정보 형식의 다른 오류를 예상할 수 있으므로 이 함수를 연속해서 호출하여 각 유형의 세부 정보를 읽으려고 할 수 있습니다. 이 경우 오류 세부 정보에서 요소 이름이 예상 값과 일치하지 않으면 NULL 포인터를 반환하는 WS_READ_OPTIONAL_POINTER 값을 지정할 수 있습니다.

  • 여러 요소를 단일 값으로 읽습니다. 이 경우 WS_ELEMENT_DESCRIPTION elementLocalName 및 elementNs 필드를 NULL로 설정하고 WS_STRUCT_TYPE 및 WS_STRUCT_DESCRIPTION 지정해야 합니다. 역직렬화되는 구조체 값의 각 필드는 본문 내에서 읽을 요소에 해당해야 합니다. readOption 매개 변수는 WS_READ_REQUIRED_VALUE 또는 WS_READ_REQUIRED_POINTER 합니다.

요구 사항

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