Fungsi MpScanStart
Memulai operasi pemindaian.
HRESULT WINAPI MpScanStart(
_In_ MPHANDLE hMpHandle,
_In_ MPSCAN_TYPE ScanType,
_In_ DWORD dwScanOptions,
_In_opt_ PMPSCAN_RESOURCES pScanResources,
_In_opt_ PMPCALLBACK_INFO pCallbackInfo,
_Out_ PMPHANDLE phScanHandle
);
-
hMpHandle [in]
-
Jenis: MPHANDLE
Tangani ke antarmuka manajer perlindungan malware. Handel ini dikembalikan oleh fungsi MpManagerOpen .
-
ScanType [in]
-
Jenis: MPSCAN_TYPE
Menentukan jenis pemindaian. Parameter ini harus menjadi salah satu anggota enuerasi MPSCAN_TYPE .
-
dwScanOptions [in]
-
Jenis: DWORD
Menentukan berbagai opsi untuk operasi pemindaian.
Nilai Makna - MPSCAN_OPTION_NONE
Tidak ada opsi khusus yang diminta. - MPSCAN_OPTION_ASYNC
Operasi pemindaian adalah asinkron, di mana MpScanStart kembali segera setelah inisiasi pemindaian berhasil. (Secara default operasi pemindaian sinkron, yang berarti MpScanStart akan kembali hanya setelah pemindaian selesai.) - MPSCAN_OPTION_PROGRESS
Pemanggil tertarik untuk menerima informasi kemajuan pemindaian melalui panggilan balik. - MPSCAN_OPTION_LOWPRIORITY
Lakukan pemindaian dengan prioritas rendah. (Secara default, operasi pemindaian dilakukan dengan prioritas normal.) - MPSCAN_OPTION_PACKEDEXES
Pindai executable yang dikemas untuk kemungkinan ancaman. - MPSCAN_OPTION_ARCHIVES
Pindai konten arsip untuk kemungkinan ancaman. Arsip adalah file dengan ekstensi seperti .zip, .cab, atau .tar. - MPSCAN_OPTION_HEURISTICS
Aktifkan pemindaian berbasis heuristik. Ini akan memindai ancaman dengan jenis deteksi yang diatur ke heuristik. - MPSCAN_OPTION_REPORTFRIENDLY
Melaporkan item yang mudah diingat dalam pemindaian sumber daya. Ini hanya ditujukan untuk penggunaan internal. - MPSCAN_OPTION_REPORTUNKNOWN
Melaporkan item yang tidak diketahui dalam pemindaian sumber daya. Ini hanya ditujukan untuk penggunaan internal. - MPSCAN_OPTION_NOCONSOLIDATE
Jangan mengonsolidasikan hasil pemindaian dengan tampilan ancaman global. Ini berguna untuk klien (seperti klien email) yang ingin mengontrol pembersihan UX dengan sendirinya daripada mengizinkan UX pembersihan anti-malware default. Ini hanya ditujukan untuk penggunaan internal. -
pScanResources [in, opsional]
-
Jenis: PMPSCAN_RESOURCES
Penunjuk ke informasi sumber daya pemindaian. Parameter ini harus NULL untuk pemindaian cepat. Ini adalah parameter opsional untuk pemindaian penuh. Untuk pemindaian sumber daya, parameter ini harus ditentukan dengan setidaknya satu struktur informasi sumber daya. Untuk memindai sumber daya tertentu, pemanggil harus memiliki izin GENERIC_READ untuk sumber daya. Lihat MPSCAN_RESOURCES.
-
pCallbackInfo [in, opsional]
-
Jenis: PMPCALLBACK_INFO
Penunjuk ke informasi panggilan balik yang digunakan untuk memberi umpan kepada klien dengan perubahan status pemindaian (seperti mulai dan selesai) dan informasi kemajuan. MPCALLBACK_DATA yang diteruskan kembali dalam fungsi panggilan balik melaporkan status pemindaian aktual dan informasi terkait kemajuan. Berikut ini adalah daftar kemungkinan panggilan balik:
Nilai Makna - MPNOTIFY_SCAN_START
Operasi pemindaian dimulai. - MPNOTIFY_SCAN_COMPLETE
Operasi pemindaian selesai. Informasi tambahan tersedia melalui struktur MPSCAN_DATA . - MPNOTIFY_SCAN_PAUSED
Operasi pemindaian dijeda. - MPNOTIFY_SCAN_RESUMED
Operasi pemindaian dilanjutkan dari jeda. - MPNOTIFY_SCAN_CANCEL
Operasi pemindaian dibatalkan. - MPNOTIFY_SCAN_PROGRESS
Pindai informasi kemajuan. Informasi tambahan (seperti statistik sumber daya) tersedia melalui struktur MPSCAN_DATA . - MPNOTIFY_SCAN_ERROR
Pindai informasi kesalahan untuk sumber daya tertentu. Informasi sumber daya tertentu tersedia melalui struktur MPSCAN_DATA . - MPNOTIFY_SCAN_INFECTED
Pemindaian menemukan sumber daya yang terinfeksi. Perhatikan bahwa dalam sebagian besar kasus ini akan mengakibatkan beberapa ancaman yang dilaporkan di akhir pemindaian. Terkadang mungkin tidak terwujud sebagai ancaman karena pengecualian. Informasi sumber daya tambahan yang terinfeksi tersedia melalui struktur MPSCAN_DATA . - MPNOTIFY_SCAN_MEMORYSTART
Bagian pemindaian cepat dari pemindaian penuh telah dimulai. - MPNOTIFY_SCAN_MEMORYCOMPLETE
Bagian pemindaian cepat dari pemindaian penuh telah selesai. - MPNOTIFY_INTERNAL_FAILURE
Operasi pemindaian mengalami kegagalan umum. hResult di MPCALLBACK_DATA memiliki kode kesalahan tertentu. -
phScanHandle [out]
-
Jenis: PMPHANDLE
Handel pemindaian yang dikembalikan yang mengidentifikasi pemindaian yang saat ini dimulai. Handel ini dapat digunakan dalam panggilan fungsi berikutnya, seperti untuk mengambil hasil pemindaian. Handel harus ditutup dengan fungsi MpHandleClose .
Jenis: HRESULT
Jika fungsi berhasil, nilai yang dikembalikan S_OK.
Jika fungsi gagal, maka nilai yang dikembalikan adalah kode HRESULT yang gagal. Pemanggil dapat menggunakan fungsi MpErrorMessageFormat untuk mendapatkan deskripsi umum tentang pesan kesalahan.
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 8 [khusus aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2012 [hanya aplikasi desktop] |
Header |
|
DLL |
|