Fungsi RpcErrorClearInformation (rpcasync.h)

  • Artikel

Fungsi RpcErrorClearInformation menghapus semua informasi kesalahan yang diperluas pada utas saat ini.

Sintaks

void RpcErrorClearInformation();

Mengembalikan nilai

Fungsi ini tidak memiliki nilai pengembalian.

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

Keterangan

Runtime RPC biasanya menangani pengosongan informasi kesalahan yang diperluas. Hanya dalam dua kasus, pemanggil harus menggunakan RpcErrorClearInformation:

  • Jika komponen panggilan menambahkan rekaman ke utas menggunakan fungsi RpcErrorAddRecord , maka memutuskan bahwa komponen tersebut tidak mengalami kesalahan fatal dan terus memproses yang asli, atau kesalahan tidak tersambung ke rekaman telah ditambahkan. Dalam hal ini, komponen panggilan perlu menghapus informasi kesalahan dari utas untuk mencegah penyebaran informasi kesalahan yang berpotensi menyesatkan.
  • Jika komponen panggilan mencoba beberapa percobaan ulang operasi yang mengembalikan informasi kesalahan yang diperluas. Ketika panggilan RPC dimulai, RUNTIME RPC menghapus informasi kesalahan yang diperluas pada utas. Namun, jika komponen panggilan memanggil RpcErrorAddRecord dalam perulangan dengan banyak iterasi, komponen tersebut mungkin ingin menghapus informasi kesalahan, karena informasi kesalahan yang diperluas menumpuk dari waktu ke waktu dan dapat menghabiskan memori yang tersedia.

Persyaratan

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

Lihat juga

Mendapatkan Informasi Kesalahan RPC yang Diperluas

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration