Fungsi RpcServerTestCancel (rpcdce.h)

Artikel
03/01/2024

Server memanggil RpcServerTestCancel untuk menguji permintaan pembatalan klien.

Sintaks

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Parameter

BindingHandle

Panggil untuk menguji perintah pembatalan. Jika nilai nol ditentukan, server meniru klien yang sedang dilayani oleh utas server ini.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan dibatalkan oleh klien. Server masih harus menyelesaikan atau membatalkan panggilan.
RPC_S_NO_CALL_ACTIVE	Tidak ada panggilan aktif pada utas saat ini.
RPC_S_CALL_IN_PROGRESS	Panggilan tidak dibatalkan.
RPC_S_INVALID_BINDING	Handel tidak valid.

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

Keterangan

Server memanggil RpcServerTestCancel untuk mengetahui apakah klien telah meminta pembatalan panggilan yang luar biasa. Fungsi RpcServerTestCancel hanya menunjukkan apakah klien telah membatalkan panggilan; status tidak diubah pada server atau klien. Panggilan yang dibatalkan masih harus diselesaikan atau dibatalkan oleh server RPC, masing-masing menggunakan panggilan fungsi RpcAsyncCompleteCall atau RpcAsyncAbortCall .

Parameter BindingHandle menentukan panggilan untuk diuji. Jika parameter memiliki nilai nol, panggilan pada utas saat ini diuji. Server dapat memanggil fungsi RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) untuk menguji pesan pembatalan menggunakan handel asinkron untuk mendapatkan handel pengikatan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll