Bagikan melalui

Fungsi WSDGenerateFaultEx (wsdutil.h)

  • Artikel

Menghasilkan kesalahan SOAP.

Sintaks

HRESULT WSDGenerateFaultEx(
  [in]  WSDXML_NAME               *pCode,
  [in]  WSDXML_NAME               *pSubCode,
  [in]  WSD_LOCALIZED_STRING_LIST *pReasons,
  [in]  LPCWSTR                   pszDetail,
  [out] WSD_SOAP_FAULT            **ppFault
);

Parameter

[in] pCode

Kode kesalahan SOAP.

Daftar kemungkinan kode kesalahan berikut. Untuk deskripsi setiap kode kesalahan, lihat

Spesifikasi SOAP Versi 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Pengirim

Penerima

[in] pSubCode

Subkode kesalahan.

[in] pReasons

Struktur WSD_LOCALIZED_STRING_LIST yang berisi daftar kode alasan yang dilokalkan.

[in] pszDetail

Berisi informasi kesalahan khusus aplikasi yang berkaitan dengan kesalahan.

[out] ppFault

Struktur WSD_SOAP_FAULT yang berisi kesalahan yang dihasilkan. ppFault harus dibebaskan dengan panggilan ke WSDFreeLinkedMemory.

Nilai kembali

Kemungkinan nilai pengembalian termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_INVALIDARG
 pszCode atau pReasons adalah NULL.
E_POINTER
 ppFault adalah NULL.

Keterangan

Kesalahan SOAP menyediakan cara untuk mengomunikasikan informasi kesalahan pada pesan SOAP yang gagal. Protokol Layanan Web yang berbeda memperluas kesalahan untuk memberikan informasi kesalahan kontekstual, dan dalam beberapa kasus, seperti di WS-Eventing, kesalahan adalah bagian yang diharapkan dari pola pesan tertentu karena klien menentukan apakah perangkat mendukung fitur tertentu atau tidak.

Subkode kesalahan berikut tidak diimplementasikan oleh WSDAPI:

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • UnsupportedExpirationType
  • InvalidMessage
  • FilteringNotSupported

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header wsdutil.h (termasuk Wsdapi.h)
Pustaka Wsdapi.lib
DLL Wsdapi.dll