Fungsi WsCreateMessageForChannel (webservices.h)

Artikel
03/13/2024

Membuat pesan untuk digunakan dengan saluran tertentu.

Sintaks

HRESULT WsCreateMessageForChannel(
  [in]           WS_CHANNEL                *channel,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] channel

Arahkan ke struktur WS_CHANNEL yang mewakili saluran 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

Berbeda dengan fungsi WsCreateMessage yang lebih umum, WsCreateMessageForChannel memastikan bahwa versi pesan yang digunakan sesuai 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