Fungsi WsAbortServiceProxy (webservices.h)

Artikel
03/15/2023

Membatalkan proksi layanan, dan membatalkan I/O yang tertunda pada proksi layanan.

Sintaks

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

Parameter

[in] serviceProxy

Penunjuk ke struktur WS_SERVICE_PROXY yang mewakili proksi layanan untuk dibatalkan.

[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
E_INVALIDARG	Satu atau beberapa argumen tidak valid.

Keterangan

WsAbortServiceProxy menunjukkan perilaku berikut tergantung pada status proksi layanan (lihat enumerasi WS_SERVICE_PROXY_STATE untuk kemungkinan status):

Jika proksi layanan terbuka dan dalam status WS_SERVICE_PROXY_STATE_OPENING, Anda dapat memanggil WsAbortServiceProxy untuk membatalkan operasi pembukaan. Proksi layanan akan membatalkan semua I/O yang tertunda dan transisi kembali ke status WS_SERVICE_PROXY_STATE_CREATED.
Jika proksi layanan sudah terbuka dan dalam status WS_SERVICE_PROXY_STATE_OPEN, WsAbortServiceProxy akan menyebabkan proksi layanan membatalkan semua saluran dan transisi yang mendasar ke status WS_SERVICE_PROXY_STATE_FAULTED. Setelah pembatalakuan dimulai, proksi layanan tidak akan menerima panggilan baru apa pun. Aplikasi dapat memanggil WsCloseServiceProxy untuk menutupnya
Jika proksi layanan ditutup dan dalam status WS_SERVICE_PROXY_STATE_CLOSING, semua saluran yang mendasar dibatalkan, dan proksi layanan beralih ke status WS_SERVICE_PROXY_STATE_CLOSED.

Untuk contoh penggunaan fungsi ini, lihat ServiceCancellationExample.

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