Fungsi WsInitializeMessage (webservices.h)

Artikel
03/13/2024

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.

Catatan Jika nilai inisialisasi diatur ke WS_REPLY_MESSAGE atau WS_FAULT_MESSAGE pesan ditangani secara otomatis.

[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
E_OUTOFMEMORY	Kehabisan memori.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
Kesalahan Lain	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

Bagikan melalui