Fungsi WsAbortChannel (webservices.h)

  • Artikel

Membatalkan semua I/O yang tertunda untuk saluran tertentu

Sintaks

HRESULT WsAbortChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

Parameter

[in] channel

Penunjuk ke struktur WS_CHANNEL yang mewakili saluran untuk membatalkan I/O.

[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_E_NOT_SUPPORTED
 Lihat bagian Keterangan untuk batasan platform.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.

Keterangan

Windows Server 2003 dan sebelumnya: Pada platform Windows sebelum Windows Vista, fungsi ini tidak didukung untuk WS_UDP_CHANNEL_BINDING atau WS_HTTP_CHANNEL_BINDING jika saluran dalam status WS_CHANNEL_STATE_ACCEPTING dan pendengar belum dibatalkan.

(Untuk informasi tentang pengikatan saluran dan status saluran, lihat enumerasi WS_CHANNEL_BINDING dan WS_CHANNEL_STATE .)

Fungsi ini juga tidak didukung untuk WS_HTTP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_REPLY saat membatalkan saluran dalam status WS_CHANNEL_STATE_OPEN atau WS_CHANNEL_STATE_FAULTED. (Untuk informasi tentang jenis saluran, lihat enumerasi WS_CHANNEL_TYPE .

WsAbortChannel dapat dipanggil untuk saluran dalam status apa pun, dan tidak menunggu I/O tertunda selesai sebelum membatalkan saluran.

Jika saluran dalam status WS_CHANNEL_STATE_OPEN , WsAbortChannel menyebabkan saluran rusak ke status WS_CHANNEL_STATE_FAULTED .

Catatan Lihat WsAbandonMessage untuk informasi tentang cara melewati pesan tertentu dan menjaga saluran tetap terbuka.

 
Jika dipanggil dengan parameter yang valid, fungsi ini tidak akan gagal karena alasan seperti kurangnya sumber daya sistem. Namun, perhatikan batasan pada beberapa versi sistem operasi di awal Komentar.

Persyaratan

   
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header webservices.h
Pustaka WebServices.lib
DLL WebServices.dll