Fungsi WsCloseServiceHost (webservices.h)

  • Artikel

Menutup komunikasi dengan host layanan yang ditentukan.

Sintaks

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

Parameter

[in] serviceHost

Penunjuk ke struktur WS_SERVICE_HOST yang mewakili host layanan yang akan ditutup.

[in, optional] asyncContext

Arahkan ke struktur WS_ASYNC_CONTEXT yang berisi informasi untuk memanggil fungsi secara asinkron. Teruskan NULL untuk memanggil fungsi secara 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_INVALID_OPERATION
 Status host layanan saat ini tidak valid untuk operasi ini.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
WS_E_OPERATION_TIMED_OUT
 Operasi tidak selesai dalam waktu yang dialokasikan.
WS_E_OPERATION_ABORTED
 Operasi dibatalkan.
Kesalahan Lain
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

WsCloseServiceHost menutup semua listener di host layanan. Akibatnya, tidak ada saluran baru yang diterima dari klien. Namun, I/O yang tertunda pada saluran yang sudah diterima diizinkan untuk diselesaikan.

Ini memiliki implikasi bagi titik akhir yang dikonfigurasi untuk berjalan dengan pengikatan saluran berbasis sesi. Jika klien memiliki sesi terbuka dengan layanan pada titik akhir seperti itu, penutupan tidak akan selesai sampai klien menutup sesi dengan layanan.

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