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.
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 |