共用方式為

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或 pCoNtext 為 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