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를 해제해야 합니다.
반환 값
가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.
반환 코드 | 설명 |
---|---|
|
메서드가 성공적으로 완료되었습니다. |
|
pszCode, pszReason 또는 pContext 는 NULL입니다. |
|
ppFault 는 NULL입니다. |
설명
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 |