Fungsi WsAddressMessage (webservices.h)

Artikel
08/27/2023

Membahas pesan ke alamat titik akhir tertentu.

Sintaks

HRESULT WsAddressMessage(
  [in]           WS_MESSAGE                *message,
  [in, optional] const WS_ENDPOINT_ADDRESS *address,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] message

Arahkan ke struktur WS_MESSAGE yang mewakili pesan yang akan ditangani.

[in, optional] address

Arahkan ke struktur WS_ENDPOINT_ADDRESS yang berisi titik akhir untuk mengatasi pesan.

Catatan Meneruskan NULL ke parameter ini menunjukkan bahwa tidak ada header yang ditambahkan ke pesan. Ini menyediakan cara untuk mengatur WS_MESSAGE_PROPERTY_ID ke WS_MESSAGE_PROPERTY_IS_ADDRESSED tanpa mengubah kumpulan header dalam pesan.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Nilai kembali

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

Menampilkan kode	Deskripsi
WS_E_INVALID_OPERATION	Pesan telah ditangani. (Properti WS_MESSAGE_PROPERTY_IS_ADDRESSED menunjukkan apakah pesan telah ditangani.)
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Jika Anda tidak mengatasi pesan dengan memanggil fungsi ini, saluran secara otomatis membahas pesan dengan Alamat Titik Akhir yang diteruskan ke WsOpenChannel.

Fungsi ini menandai pesan sebagai ditujukan dengan mengatur properti WS_MESSAGE_PROPERTY_IS_ADDRESSED ke TRUE.

Fungsi ini gagal jika pesan telah ditangani dan mengembalikan WS_E_INVALID_OPERATION.

Jika WS_ENDPOINT_ADDRESSnon-NULL diteruskan ke fungsi , fungsi melakukan langkah-langkah tambahan berikut:

Jenis header diatur ke WS_TO_HEADER (lihat enumerasi WS_HEADER_TYPE ) dan alamat diatur ke nilai bidang urlWS_ENDPOINT_ADDRESS. Jika panjang URL adalah nol representasi khusus WS_ADDRESSING_VERSION untuk URL anonim diatur untuk pesan.
Setiap header dalam WS_XML_BUFFER yang ditentukan di bidang header WS_ENDPOINT_ADDRESS ditambahkan ke pesan. Tidak ada header yang ditambahkan jika buffer adalah NULL.

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