Fungsi WsSendMessage (webservices.h)
Kirim pesan di saluran menggunakan serialisasi untuk menulis elemen isi.
Sintaks
HRESULT WsSendMessage(
[in] WS_CHANNEL *channel,
[in] WS_MESSAGE *message,
[in] const WS_MESSAGE_DESCRIPTION *messageDescription,
[in] WS_WRITE_OPTION writeOption,
const void *bodyValue,
[in] ULONG bodyValueSize,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parameter
[in] channel
Saluran untuk mengirim pesan.
[in] message
Objek pesan yang digunakan untuk mengirim.
Objek pesan harus dalam WS_MESSAGE_STATE_EMPTY atau WS_MESSAGE_STATE_INITIALIZED.
[in] messageDescription
Bidang tindakan WS_MESSAGE_DESCRIPTION digunakan sebagai header tindakan untuk pesan. Bidang ini mungkin NULL jika tidak ada tindakan yang diperlukan.
Bidang bodyElementDescription dari WS_MESSAGE_DESCRIPTION digunakan untuk menserialisasikan isi pesan. Bidang ini mungkin NULL jika tidak ada elemen isi yang diinginkan. Lihat WsWriteBody untuk informasi tentang bagaimana bodyElementDescription digunakan untuk menserialisasikan nilai.
[in] writeOption
Apakah elemen isi diperlukan, dan bagaimana nilai dialokasikan. Ini hanya digunakan ketika elemen tubuh diinginkan. Untuk informasi selengkapnya, lihat WS_WRITE_OPTION dan WsWriteBody.
bodyValue
Nilai untuk diserialisasikan dalam isi pesan.
[in] bodyValueSize
Ukuran nilai yang diserialisasikan, dalam byte.
[in, optional] asyncContext
Informasi tentang cara memanggil fungsi secara asinkron, atau NULL jika memanggil secara sinkron.
[in, optional] error
Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.
Nilai kembali
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Operasi asinkron masih tertunda. |
|
Operasi dibatalkan. |
|
Operasi tidak diperbolehkan karena status objek saat ini. |
|
Titik akhir jarak jauh tidak ada atau tidak dapat ditemukan. |
|
Akses ditolak oleh titik akhir jarak jauh. |
|
Koneksi dengan titik akhir jarak jauh dihentikan. |
|
Titik akhir jarak jauh tidak dapat memproses permintaan. |
|
Titik akhir jarak jauh saat ini tidak dalam layanan di lokasi ini. |
|
Titik akhir jarak jauh tidak dapat memproses permintaan karena kelebihan beban. |
|
Titik akhir jarak jauh tidak dapat dijangkau. |
|
URL alamat titik akhir tidak valid. |
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
|
Operasi tidak selesai dalam waktu yang dialokasikan. |
|
Akses ditolak oleh server proksi HTTP. |
|
Server proksi HTTP tidak dapat memproses permintaan. |
|
Kuota terlampaui. |
|
Verifikasi keamanan tidak berhasil untuk data yang diterima. |
|
Operasi keamanan gagal dalam kerangka kerja Windows Web Services. |
|
Token keamanan ditolak oleh server karena telah kedaluwarsa. |
|
Server proksi HTTP memerlukan skema autentikasi HTTP 'dasar'. |
|
Server proksi HTTP memerlukan skema autentikasi HTTP 'digest'. |
|
Server proksi HTTP memerlukan skema autentikasi HTTP 'negosiasi'. |
|
Server proksi HTTP memerlukan skema autentikasi HTTP 'NTLM'. |
|
Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'dasar'. |
|
Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'digest'. |
|
Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'negosiasi'. |
|
Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'NTLM'. |
|
Sertifikat yang diperlukan tidak dalam periode validitasnya ketika memverifikasi terhadap jam sistem saat ini atau tanda waktu dalam file yang ditandatangani. |
|
Nama CN sertifikat tidak cocok dengan nilai yang diteruskan. |
|
Rantai sertifikat diproses, tetapi diakhiri dalam sertifikat akar yang tidak dipercaya oleh penyedia kepercayaan. |
|
Sertifikat tidak valid untuk penggunaan yang diminta. |
|
Fungsi pencabutan tidak dapat memeriksa pencabutan karena server pencabutan sedang offline. |
|
Kehabisan memori. |
|
Satu atau beberapa argumen tidak valid. |
|
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas. |
Keterangan
Untuk menyertakan header kustom dengan pesan, inisialisasi pesan WsInitializeMessage dengan WS_BLANK_MESSAGE lalu tambahkan header menggunakan WsAddCustomHeader sebelum memanggil fungsi ini.
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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk