Fungsi WsCreateChannelForListener (webservices.h)

  • Artikel

Membuat saluran yang terkait dengan pendengar tertentu.

Sintaks

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] listener

Arahkan ke struktur WS_LISTENER yang mewakili pendengar untuk membuat saluran. Pendengar dapat berada dalam status apa pun. (Untuk status pendengar, lihat enumerasi WS_LISTENER_STATE .)

properties

Array struktur WS_CHANNEL_PROPERTY yang berisi nilai opsional untuk inisialisasi saluran. Ini bisa menjadi NULL, dalam hal ini, parameter propertyCount harus 0 (nol).

Untuk informasi tentang membuat saluran kustom, lihat bagian Keterangan.

[in] propertyCount

Jumlah properti dalam array properti .

channel

Jika berhasil, pointer yang menerima alamat saluran yang dibuat.
Ketika saluran tidak lagi diperlukan, Anda harus membebaskannya dengan memanggil WsFreeChannel.

[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_INVALIDARG
 Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY
 Tidak cukup memori untuk menyelesaikan operasi.
Kesalahan Lain
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Untuk menerima pertukaran pesan masuk, panggil fungsi WsAcceptChannel .

Karakteristik keamanan saluran sama dengan yang ditentukan untuk pendengar.

Saat Anda membuat saluran kustom (menggunakan nilai WS_CUSTOM_CHANNEL_BINDING enumerasi WS_CHANNEL_BINDING ), Anda hanya dapat menentukan properti saluran berikut:

  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Jika properti awal diperlukan untuk membuat saluran kustom, tentukan dengan menggunakan properti WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header webservices.h
Pustaka WebServices.lib
DLL WebServices.dll