Fungsi WsRemoveCustomHeader (webservices.h)

Artikel
03/15/2023

Menghapus header kustom dari pesan.

Fungsi ini dirancang untuk menangani jenis header yang muncul sekali dalam pesan dan ditargetkan pada penerima utama. Header yang ditargetkan dengan peran selain penerima utama diabaikan.

Sintaks

HRESULT WsRemoveCustomHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in]           const WS_XML_STRING *headerNs,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] message

Penunjuk ke objek Pesan dengan header yang akan dihapus.

Pesan dapat berada dalam status apa pun kecuali WS_MESSAGE_STATE_EMPTY.

[in] headerName

Penunjuk ke objek WS_XML_STRING yang mereferensikan "nama lokal" elemen header yang akan dihapus.

[in] headerNs

Penunjuk ke objek WS_XML_STRING yang mereferensikan namespace elemen header yang akan dihapus.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
WS_E_INVALID_FORMAT	Ada beberapa contoh jenis header yang ada dalam pesan.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk membuat serial header.
E_INVALIDARG	Satu atau beberapa parameter salah.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Jika header dari jenis yang diberikan ada dalam pesan, header tersebut akan dihapus. Jika header tidak ada, fungsi tidak mengambil tindakan dan berhasil diselesaikan.

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