Fungsi WsAcceptChannel (webservices.h)

Artikel
03/13/2024

Menerima pesan masuk berikutnya dari pendengar yang ditentukan.

Sintaks

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

Parameter

[in] listener

Arahkan ke struktur WS_LISTENER yang mewakili pendengar. Ini adalah listener yang diteruskan ke WsCreateChannelForListener ketika saluran dibuat.

[in] channel

Arahkan ke struktur WS_CHANNEL yang mewakili saluran yang akan diterima.

[in, optional] asyncContext

Arahkan ke struktur data WS_ASYNC_CONTEXT dengan informasi untuk memanggil fungsi secara asinkron. Berikan nilai NULL untuk operasi 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	Pendengar atau saluran dibatalkan.
WS_E_OBJECT_FAULTED	Pendengar telah salah. Lihat bagian Keterangan.
WS_E_INVALID_OPERATION	Pendengar atau saluran atau keduanya dalam keadaan tidak pantas. Lihat bagian Keterangan.
WS_E_ENDPOINT_DISCONNECTED	Koneksi dengan titik akhir jarak jauh dihentikan.
WS_E_OPERATION_TIMED_OUT	Operasi tidak selesai dalam waktu yang dialokasikan.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_E_SECURITY_VERIFICATION_FAILURE	Verifikasi keamanan tidak berhasil untuk data yang diterima.
WS_E_SECURITY_SYSTEM_FAILURE	Operasi keamanan gagal dalam kerangka kerja Windows Web Services.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Setelah Anda menerima saluran, Anda harus menutupnya ketika Anda tidak lagi membutuhkannya dan membebaskan sumber daya dengan memanggil
Fungsi WsCloseChannel , lalu memanggil WsFreeChannel atau WsResetChannel. Fungsi.

Agar WsAcceptChannel berhasil, pendengar harus dalam status WS_LISTENER_STATE_OPEN, dan saluran harus dalam status WS_CHANNEL_STATE_CREATED. Untuk informasi selengkapnya, lihat enumerasi WS_LISTENER_STATE dan WS_CHANNEL_STATE .

Jika pendengar dalam status WS_LISTENER_STATE_FAULTED ,
WsAcceptChannel segera mengembalikan kode kesalahan WS_E_OBJECT_FAULTED . Jika aplikasi memanggil WsAcceptChannel dalam perulangan, aplikasi harus memeriksa kesalahan ini, sehingga dapat mengakhiri perulangan.

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