Bagikan melalui

Fungsi WsCloseServiceProxy (webservices.h)

  • Artikel

Menutup komunikasi dengan proksi layanan yang ditentukan.

Sintaks

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] serviceProxy

Penunjuk ke struktur WS_SERVICE_PROXY yang mewakili proksi layanannya untuk 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 proksi layanan saat ini tidak valid untuk operasi ini. Ini hanya kesalahan yang penutupannya akan gagal.
WS_E_ENDPOINT_DISCONNECTED
 WS_CHANNEL yang mendasar terputus selama operasi penutupan. Kesalahan ini hanya terjadi dalam kasus di mana saluran yang mendasar berbasis sesi.
WS_E_OPERATION_ABORTED
 Operasi dibatalkan.
WS_E_ENDPOINT_FAILURE
 Titik akhir jarak jauh tidak dapat memproses permintaan.
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_QUOTA_EXCEEDED
 Kuota terlampaui.
E_OUTOFMEMORY
 Tidak cukup memori untuk menyelesaikan operasi.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
Kesalahan Lain
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Jika panggilan operasi layanan tertunda pada proksi layanan, WsCloseServiceProxy menunggu setiap panggilan selesai. Setelah memanggil aplikasi WsCloseServiceProxy tidak boleh melakukan panggilan lagi pada proksi layanan.

Perhatikan bahwa WS_E_INVALID_OPERATION adalah satu-satunya
kode kesalahan yang menunjukkan bahwa penutupan telah gagal. Kode kesalahan lainnya menunjukkan bahwa operasi berhasil, dan kode kesalahan hanya untuk tujuan informasi.

Persyaratan

   
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