Fungsi WsCreateListener (webservices.h)

Artikel
08/27/2023

Membuat pendengar dengan properti yang ditentukan.

Sintaks

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

Parameter

[in] channelType

Jenis saluran yang didengarkan pendengar. Untuk jenis saluran, lihat enumerasi WS_CHANNEL_TYPE .

[in] channelBinding

Protokol saluran untuk pendengar. Untuk kemungkinan pengikatan, lihat enumerasi WS_CHANNEL_BINDING .

properties

Penunjuk ke struktur WS_LISTENER_PROPERTY yang berisi properti opsional untuk pendengar.

Untuk informasi tentang properti mana yang dapat Anda tentukan saat membuat pendengar, lihat enumerasi WS_LISTENER_PROPERTY_ID .

Untuk informasi tentang membuat pendengar kustom, lihat bagian Keterangan.

[in] propertyCount

Jumlah properti dalam array properti .

[in, optional] securityDescription

Penunjuk ke struktur WS_SECURITY_DESCRIPTION yang menentukan keamanan untuk pendengar.

Jika Anda membuat saluran kustom (menggunakan nilai WS_CUSTOM_CHANNEL_BINDING enumerasi WS_CHANNEL_BINDING ), deskripsi keamanan harus NULL. Lihat bagian Keterangan.

listener

Jika berhasil, pointer yang menerima alamat struktur WS_LISTENER mewakili pendengar baru.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode	Deskripsi
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.
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

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

WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS

(Lihat enumerasi WS_LISTENER_PROPERTY_ID .) Jika properti awal lainnya diperlukan untuk membuat pendengar kustom, tentukan dengan menggunakan properti WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS.

Untuk meneruskan informasi keamanan ke implementasi pendengar kustom, gunakan nilai WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS enumerasi WS_LISTENER_PROPERTY_ID .

Persyaratan


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

Share via