Fungsi WsWriteMessageStart (webservices.h)
Tulis semua header pesan ke saluran, dan bersiaplah untuk menulis elemen isi.
Sintaks
HRESULT WsWriteMessageStart(
[in] WS_CHANNEL *channel,
[in] WS_MESSAGE *message,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parameter
[in] channel
Saluran yang digunakan untuk menulis pesan.
[in] message
Pesan untuk ditulis.
[in, optional] asyncContext
Informasi tentang cara memanggil fungsi secara asinkron, atau NULL jika memanggil secara sinkron.
[in, optional] error
Menentukan tempat informasi kesalahan tambahan harus disimpan jika fungsi gagal.
Mengembalikan nilai
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
Awal pesan, termasuk kumpulan header saat ini yang ada dalam pesan, ditulis ke saluran.
Fungsi ini seperti WsWriteEnvelopeStart tetapi digunakan dengan saluran.
Pesan harus dalam status WS_MESSAGE_STATE_INITIALIZED . Setelah berhasil, pesan akan beralih ke status WS_MESSAGE_STATE_WRITING .
Untuk membuat serialisasi elemen isi pesan, gunakan WsWriteBody. Untuk menulis langsung ke Penulis XML pesan, pertama-tama dapatkan pembaca menggunakan properti WS_MESSAGE_PROPERTY_BODY_WRITER .
Jika output saluran dialirkan (WS_STREAMED_OUTPUT_TRANSFER_MODE), maka WsFlushBody harus dipanggil untuk benar-benar mengirimkan setiap bagian tubuh.
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 |