Fungsi panggilan balik LPEVALCOMCALLBACK (evalcom2.h)

Artikel
29/02/2024

Spesifikasi LPEVALCOMCALLBACK mendefinisikan prototipe fungsi panggilan balik. Metode IValidate::SetStatus memungkinkan alat penulisan untuk menerima informasi tentang kemajuan validasi melalui fungsi panggilan balik terdaftar.

Sintaks

LPEVALCOMCALLBACK Lpevalcomcallback;

BOOL Lpevalcomcallback(
  [in] STATUSTYPES iStatus,
       LPCWSTR szData,
       LPVOID pContext
)
{...}

Parameter

[in] iStatus

Menentukan pesan status yang dikirim oleh evalcom2.

Nilai	Makna
NULL	Nilai param ini
ieStatusICECount 1	Jumlah IE yang sedang dijalankan.
ieStatusMerge 2	Menggabungkan paket atau menggabungkan modul dengan file .cub.
ieStatusSummaryInfo 3	Menggabungkan aliran informasi ringkasan.
ieStatusCreateEngine 4	Bersiap untuk menjalankan IE.
ieStatusRunICE 5	Menjalankan ICE individu.
ieStatusStarting 6	Memulai validasi.
ieStatusShutdown 7	Selesaikan menjalankan IE.
ieStatusSuccess 8	Validasi berhasil diselesaikan.
ieStatusFail 9	Validasi gagal.
ieStatusCancel 10	Validasi dibatalkan.

szData

Nilai string yang berisi informasi yang sesuai dengan status. Nilai szwData harus berupa jumlah ICEs yang dijalankan jika iStatus adalah ieStatusICECount. Nilai szwData harus menjadi nama ICE yang dijalankan jika iStatus adalah ieStatusRunICE. Jika tidak, nilai szwData harus NULL. Fungsi panggilan balik harus menerima NULL sebagai nilai yang mungkin untuk parameter ini.

pContext

Penunjuk ke konteks aplikasi yang diteruskan ke metode SetStatus . Parameter ini dapat digunakan untuk pemeriksaan kesalahan.

Nilai kembali

Mengembalikan kode/nilai	Deskripsi
BENAR 1	Prosedur validasi harus dilanjutkan.
PALSU 0	Validasi dibatalkan. Fungsi panggilan balik mengembalikan FALSE untuk menghentikan validasi.

Keterangan

Metode SetStatus dan LPEVALCOMCALLBACK dapat digunakan untuk memberikan informasi kemajuan. Misalnya, pesan ieStatusICECount dapat memberikan jumlah centang keseluruhan untuk bilah kemajuan. Untuk setiap pesan ieStatusRunICE yang diterima, pemanggil dapat menaikkan bilah kemajuan satu centang.