Bagikan melalui


Fungsi RpcAsyncAbortCall (rpcasync.h)

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

Lihat juga

RPC asinkron

RPC_ASYNC_STATE

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle

RpcServerTestCancel