Fungsi RpcAsyncAbortCall (rpcasync.h)

Artikel
08/25/2023

Server memanggil RpcAsyncAbortCall untuk membatalkan panggilan asinkron.

Sintaks

RPC_STATUS RpcAsyncAbortCall(
  PRPC_ASYNC_STATE pAsync,
  unsigned long    ExceptionCode
);

Parameter

pAsync

Arahkan ke struktur RPC_ASYNC_STATE yang berisi informasi panggilan asinkron.

ExceptionCode

Kode pengecualian khusus aplikasi bukan nol. Dapat berupa kode kesalahan yang ditentukan aplikasi, atau kode kesalahan RPC standar. Untuk informasi selengkapnya, lihat NILAI Pengembalian RPC.

Menampilkan nilai

Nilai	Makna
RPC_S_OK	Pembatalan panggilan berhasil.
RPC_S_INVALID_ASYNC_HANDLE	Handel asinkron tidak valid.

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

Keterangan

Server memanggil RpcAsyncAbortCall ketika keadaan mengharuskannya untuk membatalkan panggilan asinkron sebelum selesai. Misalnya, pemanggil mungkin tidak memiliki izin yang diperlukan untuk membuat permintaan, atau server mungkin terlalu sibuk untuk memproses panggilan. Gunakan parameter ExceptionCode untuk menentukan alasan batalkan. Lingkungan run-time menyebarluaskan kode pengecualian kepada klien sebagai kesalahan.

Ketika panggilan asinkron dibatalkan dengan RpcAsyncAbortCall, tidak ada marshaling argumen output yang dilakukan, dan semua argumen input dikosongkan oleh RPC. Ketika RpcAsyncAbortCall dipanggil, panggilan ke fungsi RpcAsyncCompleteCall tidak diperlukan. Fungsi RpcAsyncAbortCall harus dipanggil hanya sekali untuk panggilan asinkron; panggilan kedua dapat merusak proses atau gagal dengan cara lain yang tidak terduga.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	rpcasync.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll