共用方式為

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)
程式庫 Wsdapi.lib
Dll Wsdapi.dll