Fungsi WsOpenListener (webservices.h)

  • Artikel

Memulai "mendengarkan" pada alamat tertentu. Setelah pendengar dibuka, saluran dapat diterima darinya. Jika pembukaan berhasil, Listener harus ditutup menggunakan fungsi WsCloseListener sebelum sumber daya Listener dapat dirilis.

Sintaks

HRESULT WsOpenListener(
  [in]           WS_LISTENER            *listener,
  [in]           const WS_STRING        *url,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] listener

Penunjuk ke objek Pendengar untuk dibuka. Penunjuk harus mereferensikan objek WS_LISTENER yang valid dan nilai yang dirujuk mungkin bukan NULL.

[in] url

Penunjuk ke objek yang berisi string alamat URL untuk Listener.

Catatan URL selalu dalam bentuk escape.. URL mungkin tidak berisi string atau fragmen kueri. URL ini dapat mencakup kartubebas '+' atau '*' di bagian nama host, atau nama host, atau alamat IP harfiah. Lihat Keterangan untuk informasi selengkapnya tentang URL.
 

[in, optional] asyncContext

Penunjuk ke objek A WS_ASYNC_CONTEXT yang memiliki informasi tentang cara memanggil fungsi secara asinkron. Nilai diatur ke NULL jika memanggil secara sinkron.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
WS_S_ASYNC
 Operasi asinkron masih tertunda.
WS_E_OPERATION_ABORTED
 Pendengar dibatalkan selama pembukaan, atau sebelum pembukaan.
WS_E_INVALID_OPERATION
 Pendengar dalam keadaan salah.
WS_E_ADDRESS_IN_USE
 Alamat sudah digunakan.
WS_E_ADDRESS_NOT_AVAILABLE
 Alamat tidak valid untuk konteks ini.
WS_E_QUOTA_EXCEEDED
 Kuota terlampaui.
WS_E_OPERATION_ABORTED
 Operasi dibatalkan.
WS_E_OPERATION_TIMED_OUT
 Operasi tidak selesai dalam waktu yang dialokasikan.
E_OUTOFMEMORY
 Kehabisan memori.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
Kesalahan Lain
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Saat menggunakan alamat IPv6, alamat tersebut harus diapit dalam tanda kurung siku di bagian nama host.

Untuk informasi selengkapnya, lihat WS_HTTP_CHANNEL_BINDING.

Untuk WS_UDP_CHANNEL_BINDING, bagian jalur URL diabaikan. Jika alamat IP literal ditentukan, alamat IP tersebut digunakan untuk mendengarkan, jika tidak, alamat IP kartubebas digunakan.

Untuk WS_TCP_CHANNEL_BINDING, bagian jalur URL dicocokkan sebagai awalan terhadap URL yang diterima.
Jika alamat IP literal ditentukan, alamat IP tersebut digunakan untuk mendengarkan, jika tidak, alamat IP kartubebas digunakan.

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