Fungsi WsAbortListener (webservices.h)

  • Artikel

Membatalkan I/O yang tertunda untuk pendengar yang ditentukan.

Sintaks

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Parameter

[in] listener

Arahkan ke struktur WS_LISTENER yang mewakili pendengar untuk membatalkan I/O.

[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.

Keterangan

WsAbortListener dapat dipanggil ketika pendengar berada dalam status apa pun. (Lihat enumerasi WS_LISTENER_STATE untuk kemungkinan status.) Jika pendengar dalam status WS_LISTENER_STATE_OPEN, fungsi ini akan memaksa pendengar untuk kesalahan (mengatur ulang ke status WS_LISTENER_STATE_FAULTED). Ketika pendengar rusak, semua upaya untuk menerima pesan darinya segera gagal dengan kode kesalahan WS_E_OBJECT_FAULTED.

Fungsi ini tidak menunggu I/O tertunda selesai.

Jika dipanggil dengan parameter yang valid, fungsi ini tidak akan gagal karena alasan seperti kurangnya sumber daya sistem.

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