Fungsi WsOpenServiceHost (webservices.h)

  • Artikel

Membuka Host Layanan untuk komunikasi dan memulai Listener di semua titik akhir. Aplikasi klien tidak dapat tersambung ke titik akhir Layanan hingga WsOpenSerivceHost dipanggil.

Sintaks

HRESULT WsOpenServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] serviceHost

Penunjuk ke objek Host Layanan untuk dibuka. Penunjuk harus mereferensikan objek WS_SERVICE_HOST valid yang dikembalikan oleh WsCreateServiceHost dan nilai Host Layanan yang direferensikan mungkin bukan NULL.

[in, optional] asyncContext

Penunjuk ke objek A WS_ASYNC_CONTEXT yang memiliki informasi tentang cara memanggil fungsi secara asinkron. Nilai diatur ke NULL jika memanggil secara sinkron.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan 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
 Host layanan dibatalkan sebelum terbuka, atau selama pembukaan.
WS_E_INVALID_OPERATION
 Status proksi layanan saat ini tidak valid untuk operasi ini.
WS_E_ADDRESS_IN_USE
 Alamat sudah digunakan.
WS_E_ADDRESS_NOT_AVAILABLE
 Alamat tidak valid untuk konteks ini.
WS_E_QUOTA_EXCEEDED
 Kuota terlampaui.
WS_E_OPERATION_ABORTED
 Operasi dibatalkan.
WS_E_OPERATION_TIMED_OUT
 Operasi tidak selesai dalam waktu yang dialokasikan.
E_OUTOFMEMORY
 Kehabisan memori.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
Kesalahan Lain
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Perhatikan bahwa semua pendengar titik akhir harus berhasil dibuka sebelum saluran apa pun diterima oleh host layanan untuk berkomunikasi dengan klien.

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