Fungsi WsOpenChannel (webservices.h)

Artikel
03/15/2023

Buka saluran ke titik akhir.

Sintaks

HRESULT WsOpenChannel(
  [in]           WS_CHANNEL                *channel,
  [in]           const WS_ENDPOINT_ADDRESS *endpointAddress,
  [in, optional] const WS_ASYNC_CONTEXT    *asyncContext,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] channel

Saluran untuk dibuka.

[in] endpointAddress

Menentukan alamat titik akhir.

[in, optional] asyncContext

Informasi tentang cara memanggil fungsi secara asinkron, atau NULL jika memanggil secara sinkron.

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
WS_S_ASYNC	Operasi asinkron masih tertunda.
WS_E_OPERATION_ABORTED	Operasi dibatalkan.
WS_E_INVALID_OPERATION	Operasi tidak diperbolehkan karena status objek saat ini.
WS_E_ENDPOINT_NOT_FOUND	Titik akhir jarak jauh tidak ada atau tidak dapat ditemukan.
WS_E_ENDPOINT_ACCESS_DENIED	Akses ditolak oleh titik akhir jarak jauh.
WS_E_ENDPOINT_DISCONNECTED	Koneksi dengan titik akhir jarak jauh dihentikan.
WS_E_ENDPOINT_FAILURE	Titik akhir jarak jauh tidak dapat memproses permintaan.
WS_E_ENDPOINT_NOT_AVAILABLE	Titik akhir jarak jauh saat ini tidak dalam layanan di lokasi ini.
WS_E_ENDPOINT_TOO_BUSY	Titik akhir jarak jauh tidak dapat memproses permintaan karena kelebihan beban.
WS_E_ENDPOINT_UNREACHABLE	Titik akhir jarak jauh tidak dapat dijangkau.
WS_E_INVALID_ENDPOINT_URL	URL alamat titik akhir tidak valid.
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_OPERATION_TIMED_OUT	Operasi tidak selesai dalam waktu yang dialokasikan.
WS_E_PROXY_ACCESS_DENIED	Akses ditolak oleh server proksi HTTP.
WS_E_PROXY_FAILURE	Server proksi HTTP tidak dapat memproses permintaan.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.
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.
WS_E_PROXY_REQUIRES_BASIC_AUTH	Server proksi HTTP memerlukan skema autentikasi HTTP 'dasar'.
WS_E_PROXY_REQUIRES_DIGEST_AUTH	Server proksi HTTP memerlukan skema autentikasi HTTP 'digest'.
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH	Server proksi HTTP memerlukan skema autentikasi HTTP 'negosiasi'.
WS_E_PROXY_REQUIRES_NTLM_AUTH	Server proksi HTTP memerlukan skema autentikasi HTTP 'NTLM'.
WS_E_SERVER_REQUIRES_BASIC_AUTH	Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'dasar'.
WS_E_SERVER_REQUIRES_DIGEST_AUTH	Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'digest'.
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH	Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'negosiasi'.
WS_E_SERVER_REQUIRES_NTLM_AUTH	Titik akhir jarak jauh memerlukan skema autentikasi HTTP 'NTLM'.
E_OUTOFMEMORY	Kehabisan memori.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Jika pembukaan berhasil, saluran harus ditutup menggunakan WsCloseChannel sebelum dapat dikosongkan.

Gunakan WsCreateChannel untuk membuat saluran.

Setelah saluran dibuka ke titik akhir, maka semua komunikasi terjadi dengan titik akhir tersebut.

Alamat titik akhir dan kontennya tidak diperlukan setelah fungsi kembali, bahkan jika fungsi dipanggil secara asinkron (misalnya, fungsi dapat dideklarasikan dengan aman pada tumpukan).

Apakah ada IO yang benar-benar terjadi selama panggilan ini akan bergantung pada jenis saluran dan pengaturannya.

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui