Fungsi WsCloseListener (webservices.h)

Artikel
03/13/2024

Menyebabkan pendengar yang ditentukan berhenti mendengarkan.

Sintaks

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

Parameter

[in] listener

Penunjuk ke struktur WS_LISTENER yang mewakili pendengar untuk ditutup.

[in, optional] asyncContext

Arahkan ke struktur WS_ASYNC_CONTEXT yang berisi informasi untuk memanggil fungsi secara asinkron. Teruskan NULL untuk memanggil fungsi secara sinkron.

[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
WS_S_ASYNC	Operasi asinkron masih tertunda.
WS_E_OPERATION_ABORTED	Penutupan dibatalkan oleh panggilan ke WsAbortListener saat pendengar ditutup.
WS_E_INVALID_OPERATION	Pendengar dalam keadaan tidak pantas.
WS_E_OPERATION_TIMED_OUT	Operasi tidak selesai dalam waktu yang dialokasikan.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
Kesalahan Lain	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Setelah pendengar ditutup, pendengar dapat dengan aman dilepaskan.

Operasi ini diizinkan untuk pendengar dalam status WS_LISTENER_STATE_OPEN atau WS_LISTENER_STATE_FAULTED . (Untuk status pendengar, lihat enumerasi WS_LISTENER_STATE .)

Ketika pendengar ditutup, setiap upaya tertunda untuk menerima saluran dengan metode WsAcceptChannel dibatalkan. Namun, WsCloseListener menunggu I/O yang tertunda selesai sebelum melanjutkan proses penutupan.

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

Share via