Fungsi WsMarkHeaderAsUnderstood (webservices.h)
Fungsi ini menandai header sebagai "dipahami" oleh aplikasi.
Kumpulan header dapat diperluas dan Asimilasi pesan oleh penerima tidak dapat diakses oleh pengirim. Fungsi ini adalah metode aplikasi penerima untuk membuatnya diketahui oleh pengirim bahwa header yang diterima telah dibaca dan dipahami.
WS_MESSAGE_STATE harus dalam set ke WS_MESSAGE_STATE_READING. Melihat. WsCheckMustUnderstandHeaders untuk informasi selengkapnya.
Sintaks
HRESULT WsMarkHeaderAsUnderstood(
[in] WS_MESSAGE *message,
[in] const WS_XML_NODE_POSITION *headerPosition,
[in, optional] WS_ERROR *error
);
Parameter
[in] message
Penunjuk ke objek Pesan dengan header untuk ditandai.
[in] headerPosition
Penunjuk ke posisi elemen header dalam segmen header XML.
[in, optional] error
Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.
Mengembalikan nilai
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Pesan tidak dalam status yang benar. |
|
Satu atau beberapa argumen tidak valid. |
|
Kehabisan memori. |
|
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas. |
Keterangan
Ketika aplikasi membaca header menggunakan Pembaca XML, aplikasi harus mendapatkan WS_XML_NODE_POSITION elemen header dan meneruskannya ke fungsi ini. Lihat WsGetReaderPosition untuk cara mendapatkan WS_XML_NODE_POSITION.
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