Fungsi WsAcceptChannel (webservices.h)
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 |
---|---|
|
Operasi asinkron masih tertunda. |
|
Pendengar atau saluran dibatalkan. |
|
Pendengar telah salah. Lihat bagian Keterangan. |
|
Pendengar atau saluran atau keduanya dalam keadaan tidak pantas. Lihat bagian Keterangan. |
|
Koneksi dengan titik akhir jarak jauh dihentikan. |
|
Operasi tidak selesai dalam waktu yang dialokasikan. |
|
Kuota terlampaui. |
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
|
Tidak cukup memori untuk menyelesaikan operasi. |
|
Satu atau beberapa argumen tidak valid. |
|
Verifikasi keamanan tidak berhasil untuk data yang diterima. |
|
Operasi keamanan gagal dalam kerangka kerja Windows Web Services. |
|
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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk