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.

Catatan Fungsi ini harus digunakan hanya jika aplikasi menerima pesan yang menunjukkan bahwa header harus dipahami dan tidak memperoleh header menggunakan WsGetHeader atau WsGetCustomHeader.

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
WS_E_INVALID_OPERATION	Pesan tidak dalam status yang benar.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Kehabisan memori.
Kesalahan Lain	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