Fungsi WsAddressMessage (webservices.h)
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.
[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 |
---|---|
|
Pesan telah ditangani. (Properti WS_MESSAGE_PROPERTY_IS_ADDRESSED menunjukkan apakah pesan telah ditangani.) |
|
Satu atau beberapa argumen tidak valid. |
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
|
Tidak cukup memori untuk menyelesaikan operasi. |
|
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 |