Fungsi WsGetHeaderAttributes (webservices.h)

Artikel
03/03/2024

Fungsi ini mengisi parameter ULONG dengan WS_HEADER_ATTRIBUTES dari elemen header tempat pembaca diposisikan. Versi amplop pesan digunakan untuk menentukan atribut mana yang akan dikembalikan.

Sintaks

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] message

Penunjuk ke struktur WS_MESSAGE yang berisi pesan untuk dikueri. Versi amplop pesan ini digunakan untuk menentukan atribut mana yang cocok. Pesan dapat berada dalam status apa pun kecuali WS_MESSAGE_STATE_EMPTY.

[in] reader

Penunjuk ke pembaca untuk dikueri. Ini harus valid WS_XML_READER objek yang dikembalikan dari WsCreateReader dan tidak boleh NULL.

[out] headerAttributes

Pada keberhasilan, nilai yang dirujuk oleh pointer ini diatur ke atribut header.

[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
E_OUTOFMEMORY	Kehabisan memori.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Pembaca diasumsikan menunjuk ke elemen header. Gunakan API pembaca XML untuk memposisikan pembaca dengan tepat.

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

Bagikan melalui