Fungsi WsCreateMessage (webservices.h)

Artikel
03/03/2024

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
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
Kesalahan Lain	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

Bagikan melalui