Fungsi RpcErrorAddRecord (rpcasync.h)

Fungsi RpcErrorAddRecord menambahkan informasi kesalahan yang diperluas ke rantai catatan informasi kesalahan yang diperluas.

Sintaks

RPC_STATUS RpcErrorAddRecord(
  [in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);

Parameter

[in] ErrorInfo

Informasi kesalahan yang akan ditambahkan, dalam bentuk struktur RPC_EXTENDED_ERROR_INFO .

Nilai kembali

Penyelesaian yang berhasil mengembalikan RPC_S_OK.

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

 

Keterangan

Fungsi RpcErrorAddRecord memungkinkan aplikasi atau server selain RPC Runtime untuk menambahkan informasi kesalahan yang diperluas ke rantai catatan informasi kesalahan yang diperluas.

Tanggung jawab atas string yang ditujukkan oleh ErrorInfo milik pemanggil; fungsi RpcErrorAddRecord membuat salinan string tersebut, jika perlu. Pembatasan berikut pada anggota ErrorInfo harus diamati:

Versi harus diatur ke versi yang valid, seperti RPC_EEINFO_VERSION.

ComputerName harus diatur ke NULL. Nilai lain menghasilkan ERROR_INVALID_PARAMETER.

ProcessID harus diatur ke nol. Nilai lain menghasilkan ERROR_INVALID_PARAMETER.

SystemTime atau FileTime diabaikan pada input, dan diatur oleh RPC Runtime.

GeneratingComponent harus diatur ke nol. Nilai lain menghasilkan ERROR_INVALID_PARAMETER. Runtime RPC mengatur ini ke EEInfoGCApplication.

Status dapat diatur ke kode kesalahan yang ingin ditambahkan pemanggil ke rantai.

DetectionLocation harus diatur ke nol. Nilai lain menghasilkan ERROR_INVALID_PARAMETER.

NumberOfParameters menunjukkan jumlah parameter dalam array Parameter. Nilai ini harus sama atau lebih besar dari nol atau MaxNumberOfEEInfoParams. Runtime RPC tidak menggunakan memori apa pun setelah jumlah parameter yang ditentukan, sehingga penelepon dapat mengalokasikan memori dengan aman kurang dari parameter MaxNumberOfEEInfoParams.

Parameter mewakili parameter untuk rekaman informasi kesalahan yang diperluas. Satu-satunya batasan pada Parameter adalah bahwa Pval digunakan untuk mewakili pointer, dan selalu 64 bit. Gunakan Pval terlepas dari apakah sistem yang digunakan adalah 32 bit atau 64 bit. Jangan gunakan Lval.

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

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration