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 오류 코드입니다.
가능한 오류 코드 목록은 다음과 같습니다. 각 오류 코드에 대한 설명은 다음을 참조하세요.
VersionMismatch
MustUnderstand
DataEncodingUnknown
보낸 사람
받는 사람
[in] pSubCode
오류 하위 코드입니다.
[in] pReasons
지역화된 이유 코드 목록을 포함하는 WSD_LOCALIZED_STRING_LIST 구조체입니다.
[in] pszDetail
오류와 관련된 애플리케이션별 오류 정보를 포함합니다.
[out] ppFault
생성된 오류를 포함하는 WSD_SOAP_FAULT 구조체입니다. WSDFreeLinkedMemory를 호출하여 ppFault를 해제해야 합니다.
반환 값
가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공적으로 완료되었습니다. |
|
pszCode 또는 pReasons 는 NULL입니다. |
|
ppFault 는 NULL입니다. |
설명
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 |