Share via

struktur WS_FAULT (webservices.h)

  • Artikel

Kesalahan adalah nilai yang dibawa dalam isi pesan yang menyampaikan kegagalan pemrosesan. Kesalahan dimodelkan menggunakan struktur WS_FAULT .

Sintaks

typedef struct _WS_FAULT {
  WS_FAULT_CODE   *code;
  WS_FAULT_REASON *reasons;
  ULONG           reasonCount;
  WS_STRING       actor;
  WS_STRING       node;
  WS_XML_BUFFER   *detail;
} WS_FAULT;

Anggota

code

Kepala daftar kode kesalahan yang mengidentifikasi jenis kesalahan.

Kode kesalahan diurutkan dari yang paling umum hingga yang paling spesifik. Harus ada setidaknya satu kode kesalahan. Kode kesalahan pertama harus sesuai dengan kode kesalahan yang ditentukan oleh SOAP. Untuk WS_ENVELOPE_VERSION_SOAP_1_1, hanya kode kesalahan paling spesifik yang diserialisasikan (yang pertama dalam daftar).

Jika URI namespace dari kode kesalahan pertama adalah string kosong, maka kode kesalahan pertama akan diubah sebagai berikut ketika kesalahan diserialisasikan, sebagai berikut:

Transformasi ini memungkinkan kode kesalahan SOAP ditentukan tanpa harus khawatir tentang versi SOAP mana yang digunakan.

reasons

Teks yang menjelaskan kesalahan. Ini adalah array untuk memungkinkan bahasa yang berbeda.

reasonCount

Jumlah alasan dalam array alasan. Ini akan lebih dari satu jika teks diwakili dalam beberapa bahasa. Harus ada setidaknya satu alasan kesalahan.

Untuk WS_ENVELOPE_VERSION_SOAP_1_1, hanya alasan pertama yang diserialisasikan.

actor

Nama prosesor yang menyebabkan kesalahan. Jika panjang string nol, maka diasumsikan sebagai titik akhir.

node

Lokasi prosesor yang menyebabkan kesalahan. Jika panjang string nol, maka diasumsikan sebagai titik akhir.

Untuk WS_ENVELOPE_VERSION_SOAP_1_1, nilai ini tidak diserialisasikan.

detail

Detail kesalahan memungkinkan konten XML disertakan bersama dengan kesalahan. Jika tidak ada detail, maka bidang ini mungkin NULL.

Untuk WS_ENVELOPE_VERSION_SOAP_1_1, ini hanya boleh digunakan jika kesalahan tidak terkait dengan pemrosesan header pesan. Kesalahan yang berkaitan dengan header harus menggunakan header kustom untuk menyampaikan informasi tentang kesalahan.

Jika ada detail untuk kesalahan, WS_XML_BUFFER harus berisi elemen yang sesuai dengan elemen detail kesalahan SOAP. Konten XML khusus kesalahan terkandung dalam elemen detail. Nama lokal dan namespace elemen diabaikan; mereka diganti dengan nama elemen yang sesuai sesuai dengan WS_ENVELOPE_VERSION ketika elemen detail ditulis.

Persyaratan

   
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Header webservices.h