다음을 통해 공유


WSDGenerateFault 함수(wsdutil.h)

SOAP 오류를 생성합니다.

구문

HRESULT WSDGenerateFault(
  [in]  LPCWSTR        pszCode,
  [in]  LPCWSTR        pszSubCode,
  [in]  LPCWSTR        pszReason,
  [in]  LPCWSTR        pszDetail,
  [in]  IWSDXMLContext *pContext,
  [out] WSD_SOAP_FAULT **ppFault
);

매개 변수

[in] pszCode

SOAP 오류 코드입니다.

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

VersionMismatch

MustUnderstand

DataEncodingUnknown

보낸 사람

받는 사람

[in] pszSubCode

오류 하위 코드입니다.

[in] pszReason

오류에 대한 사람이 읽을 수 있는 설명입니다.

[in] pszDetail

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

[in] pContext

오류를 생성할 컨텍스트를 나타내는 IWSDXMLContext 인터페이스입니다.

[out] ppFault

생성된 오류를 포함하는 WSD_SOAP_FAULT 구조체입니다. 이 데이터를 사용하여 호출 애플리케이션을 수행하면 WSDFreeLinkedMemory를 호출하여 ppFault를 해제해야 합니다.

반환 값

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

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

설명

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

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

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • 지원되지 않는ExpirationType
  • InvalidMessage
  • FilteringNotSupported

요구 사항

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