Fungsi WsReadMessageStart (webservices.h)
Baca header pesan berikutnya dari saluran, dan bersiaplah untuk membaca elemen isi.
Sintaks
HRESULT WsReadMessageStart(
[in] WS_CHANNEL *channel,
[in] WS_MESSAGE *message,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parameter
[in] channel
Saluran untuk menerima dari.
[in] message
Pesan yang akan diterima.
[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.
Mengembalikan nilai
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Awal pesan berhasil diterima. |
|
Tidak ada lagi pesan yang tersedia di saluran. |
|
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
Ini membaca awal pesan berikutnya dari saluran, termasuk header pesan.
Fungsi ini seperti WsReadEnvelopeStart tetapi digunakan dengan saluran.
Setelah berhasil, header akan disimpan dalam pesan dan dapat diakses dengan cara akses acak (misalnya, menggunakan WsGetHeader).
Pesan harus dalam status WS_MESSAGE_STATE_EMPTY . Setelah berhasil, pesan akan beralih ke status WS_MESSAGE_STATE_READING .
Untuk mendeserialisasi elemen isi pesan, gunakan WsReadBody. Untuk membaca langsung dari Pembaca XML pesan, pertama-tama dapatkan pembaca menggunakan properti WS_MESSAGE_PROPERTY_BODY_READER .
Jika input saluran dialirkan (WS_STREAMED_INPUT_TRANSFER_MODE), maka WsFillBody harus dipanggil untuk menerima bagian tubuh berikutnya sebelum benar-benar dibaca.
Persyaratan
Persyaratan | Nilai |
---|---|
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