Fungsi WsInitializeMessage (webservices.h)
Fungsi ini menginisialisasi header untuk pesan dalam persiapan untuk diproses. Setelah pesan diinisialisasi, aplikasi dapat menambahkan header tambahan. Pada keberhasilan, pesan berada dalam status WS_MESSAGE_STATE_INITIALIZED . Jika fungsi gagal, maka tidak ada transisi status yang terjadi.
Sintaks
HRESULT WsInitializeMessage(
[in] WS_MESSAGE *message,
[in] WS_MESSAGE_INITIALIZATION initialization,
[in, optional] WS_MESSAGE *sourceMessage,
[in, optional] WS_ERROR *error
);
Parameter
[in] message
Penunjuk ke objek Pesan untuk diinisialisasi. Pesan harus berupa instans objek WS_MESSAGE valid yang dikembalikan oleh WsCreateMessage atau WsCreateMessageForChannel dan mungkin bukan NULL.
[in] initialization
Menentukan inisialisasi Pesan.
[in, optional] sourceMessage
Penunjuk ke objek pesan yang digunakan untuk menginisialisasi parameter pesan . Nilai ini harus NULL kecuali parameter inisialisasi memiliki nilai WS_DUPLICATE_MESSAGE, WS_REPLY_MESSAGE, atau WS_FAULT_MESSAGE.
[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 |
---|---|
|
Kehabisan memori. |
|
Satu atau beberapa argumen tidak valid. |
|
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas. |
Keterangan
Pengirim awal pesan harus menambahkan header tindakan ke pesan menggunakan WsSetHeader.
API ini harus dipanggil sebelum WsWriteEnvelopeStart atau WsWriteMessageStart dipanggil untuk pesan tersebut.
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 |