다음을 통해 공유


WSDGenerateFaultEx 함수(wsdutil.h)

SOAP 오류를 생성합니다.

구문

HRESULT WSDGenerateFaultEx(
  [in]  WSDXML_NAME               *pCode,
  [in]  WSDXML_NAME               *pSubCode,
  [in]  WSD_LOCALIZED_STRING_LIST *pReasons,
  [in]  LPCWSTR                   pszDetail,
  [out] WSD_SOAP_FAULT            **ppFault
);

매개 변수

[in] pCode

SOAP 오류 코드입니다.

가능한 오류 코드 목록은 다음과 같습니다. 각 오류 코드에 대한 설명은 다음을 참조하세요.

SOAP 버전 1.2 사양.

VersionMismatch

MustUnderstand

DataEncodingUnknown

보낸 사람

받는 사람

[in] pSubCode

오류 하위 코드입니다.

[in] pReasons

지역화된 이유 코드 목록을 포함하는 WSD_LOCALIZED_STRING_LIST 구조체입니다.

[in] pszDetail

오류와 관련된 애플리케이션별 오류 정보를 포함합니다.

[out] ppFault

생성된 오류를 포함하는 WSD_SOAP_FAULT 구조체입니다. WSDFreeLinkedMemory를 호출하여 ppFault를 해제해야 합니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드 설명
S_OK
메서드가 성공적으로 완료되었습니다.
E_INVALIDARG
pszCode 또는 pReasonsNULL입니다.
E_POINTER
ppFaultNULL입니다.

설명

SOAP 오류는 실패한 SOAP 메시지에 대한 오류 정보를 전달하는 방법을 제공합니다. 다양한 웹 서비스 프로토콜은 오류를 확장하여 상황에 맞는 오류 정보를 제공하며, WS-Eventing과 같은 경우에 클라이언트가 디바이스가 특정 기능을 지원하는지 여부를 결정할 때 오류는 특정 메시지 패턴의 예상된 부분입니다.

다음 오류 하위 코드는 WSDAPI에서 구현되지 않습니다.

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • UnsupportedExpirationType
  • InvalidMessage
  • FilteringNotSupported

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wsdutil.h(Wsdapi.h 포함)
라이브러리 Wsdapi.lib
DLL Wsdapi.dll