通过

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 或 pReasons 为 NULL。
E_POINTER
 ppFault 为 NULL。

注解

SOAP 错误提供了一种在失败的 SOAP 消息上传达错误信息的方法。 不同的 Web 服务协议扩展错误以提供上下文错误信息，在某些情况下（例如在 WS-Eventing 中），当客户端确定设备是否支持特定功能时，错误是特定消息模式的预期部分。

WSDAPI 不实现以下故障子代码：

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • UnsupportedExpirationType
  • InvalidMessage
  • FilteringNotSupported

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wsdutil.h (包括 Wsdapi.h)
Library Wsdapi.lib
DLL Wsdapi.dll