Fungsi WsCreateMessage (webservices.h)
Membuat objek pesan dengan properti yang ditentukan.
Sintaks
HRESULT WsCreateMessage(
[in] WS_ENVELOPE_VERSION envelopeVersion,
[in] WS_ADDRESSING_VERSION addressingVersion,
const WS_MESSAGE_PROPERTY *properties,
[in] ULONG propertyCount,
WS_MESSAGE **message,
[in, optional] WS_ERROR *error
);
Parameter
[in] envelopeVersion
Nilai enumerasi WS_ENVELOPE_VERSION yang menentukan versi amplop untuk pesan tersebut.
[in] addressingVersion
WS_ADDRESSING_VERSION yang menentukan versi alamat untuk pesan.
properties
Array properti opsional untuk pesan. Lihat WS_MESSAGE_PROPERTY.
Nilai parameter ini mungkin NULL, dalam hal ini, parameter propertyCount harus 0 (nol).
[in] propertyCount
Jumlah properti dalam array properti .
message
Jika berhasil, pointer yang menerima alamat struktur WS_MESSAGE yang mewakili pesan baru.
Ketika Anda tidak lagi membutuhkan struktur ini, Anda harus membebaskannya dengan memanggil WsFreeMessage.
[in, optional] error
Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.
Mengembalikan nilai
Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.
Menampilkan kode | Deskripsi |
---|---|
|
Tidak cukup memori untuk menyelesaikan operasi. |
|
Satu atau beberapa argumen tidak valid. |
|
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas. |
Keterangan
Objek pesan adalah kendaraan pengiriman untuk Windows Web Services. Objek pesan tunggal dapat digunakan untuk mengirim atau menerima pesan berurutan. Menggunakan kembali objek pesan dengan cara ini dapat mengurangi alokasi memori. Ketika Anda tidak lagi membutuhkan pesan, Anda harus membebaskan memori dengan memanggil WsFreeMessage. (Untuk informasi selengkapnya tentang menggunakan kembali objek pesan, lihat WsResetMessage .)
Jika Anda membuat pesan untuk digunakan dengan saluran tertentu, gunakan fungsi WsCreateMessageForChannel , yang akan memastikan versi pesan yang benar untuk saluran.
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 |