Bagikan melalui


Fungsi WsCloseListener (webservices.h)

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