Fungsi WsAbandonCall (webservices.h)

Artikel
08/27/2023

Meninggalkan panggilan tertentu pada proksi layanan yang ditentukan.

Sintaks

HRESULT WsAbandonCall(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in]           ULONG            callId,
  [in, optional] WS_ERROR         *error
);

Parameter

[in] serviceProxy

Arahkan ke struktur WS_SERVICE_PROXY yang mewakili proksi layanan untuk meninggalkan panggilan.

[in] callId

ID panggilan untuk ditinggalkan. (Lihat bagian Keterangan.)

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode	Deskripsi
WS_E_INVALID_OPERATION	Status proksi layanan saat ini tidak valid untuk operasi ini.
E_INVALIDARG	Proksi layanan NULL diteruskan ke fungsi.

Keterangan

Panggilan diidentifikasi dengan ID panggilan. ID panggilan ini dikaitkan dengan panggilan oleh nilai WS_CALL_PROPERTY_CALL_ID enumerasi WS_CALL_PROPERTY_ID .

Jika ID panggilan adalah 0, semua panggilan yang tertunda pada proksi layanan akan ditinggalkan. Untuk informasi selengkapnya, lihat topik berikut:

Ketahuilah bahwa I/O aktual yang terkait dengan panggilan tidak dibatalkan. Proksi layanan menyimpan sumber daya untuk menyelesaikan panggilan meskipun panggilan ditinggalkan.

Ini menghasilkan konsumsi sumber daya yang diperpajakan jika aplikasi terus meninggalkan panggilan, seperti yang dapat terjadi ketika server lambat merespons klien, dan aplikasi klien meninggalkan satu panggilan hanya untuk melakukan panggilan yang sama lagi.

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

Bagikan melalui