Fungsi WsCreateFaultFromError (webservices.h)

Artikel
03/15/2023

Membuat WS_FAULT dari objek kesalahan tertentu.

Sintaks

HRESULT WsCreateFaultFromError(
  [in]  WS_ERROR            *error,
  [in]  HRESULT             faultErrorCode,
  [in]  WS_FAULT_DISCLOSURE faultDisclosure,
  [in]  WS_HEAP             *heap,
  [out] WS_FAULT            *fault
);

Parameter

[in] error

Penunjuk ke struktur WS_ERROR yang mewakili objek kesalahan untuk membangun kesalahan.

[in] faultErrorCode

Kode kesalahan HRESULT dikembalikan dari fungsi yang gagal. Nilai HRESULT tidak dapat menjadi kode keberhasilan.

Kode kesalahan ini tidak pernah disertakan dalam kesalahan secara langsung, tetapi digunakan sebagai mekanisme fallback untuk membuat string kesalahan jika objek kesalahan tidak berisi string kesalahan apa pun.

[in] faultDisclosure

WS_FAULT_DISCLOSURE enumerasi yang mengontrol informasi apa yang disalin dari objek kesalahan ke objek kesalahan.

[in] heap

Penunjuk ke struktur WS_HEAP yang mewakili timbunan dari mana mengalokasikan memori untuk objek kesalahan yang dikembalikan.

[out] fault

Penunjuk ke struktur WS_FAULT yang mewakili objek kesalahan yang dikembalikan. Bidang objek kesalahan baik sampai WsFreeHeap atau WsResetHeap dipanggil untuk melepaskan sumber daya tumpukan yang ditentukan.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Jika objek kesalahan berisi kesalahan (yaitu, nilai WS_FAULT_ERROR_PROPERTY_FAULT WS_FAULT_ERROR_PROPERTY_IDnon-NULL), maka kesalahan tersebut dipilih untuk membangun kesalahan yang dikembalikan.

Jika objek kesalahan tidak berisi kesalahan (WS_FAULT_ERROR_PROPERTY_FAULT NULL), kesalahan umum dengan kode kesalahan generik (dan tanpa teks alasan) dipilih untuk membangun kesalahan yang dikembalikan.

Jika kesalahan yang dipilih tidak menyertakan teks alasan apa pun, teks alasan kesalahan dibangun sesuai dengan nilai parameter pengungkapan :

WS_FULL_FAULT_DISCLOSURE Semua string kesalahan yang ada dalam objek kesalahan ditambahkan bersama-sama untuk membentuk teks alasan. Jika tidak ada string, string yang terkait dengan parameter errorCode akan digunakan.
WS_MINIMAL_FAULT_DISCLOSURE String kesalahan generik digunakan.

Secara default, bahasa informasi yang bergantung pada bahasa apa pun dalam objek kesalahan adalah bahasa UI default pengguna saat ini. Namun, Anda dapat mengubah bahasa dengan mengatur properti WS_ERROR_PROPERTY_LANGID. Lihat enumerasi WS_ERROR_PROPERTY_ID .

Persyaratan


Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	webservices.h
Pustaka	WebServices.lib
DLL	WebServices.dll

Bagikan melalui