Fungsi MpScanStart

Memulai operasi pemindaian.

Sintaks

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
);

Parameter

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 .

Nilai kembali

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

Persyaratan Nilai
Klien minimum yang didukung
Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung
Windows Server 2012 [hanya aplikasi desktop]
Header
MpClient.h
DLL
MpClient.dll

Lihat juga

MpErrorMessageFormat

MpHandleClose

MpManagerBuka

MPCALLBACK_DATA

MPSCAN_DATA

MPSCAN_RESOURCES

MPSCAN_TYPE