MpScanStart 函式
啟動掃描工作。
語法
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]
-
類型： MPHANDLE
惡意程式碼保護管理員介面的控制碼。 MpManagerOpen函式會傳回此控制碼。
-
ScanType [in]
-
類型： MPSCAN_TYPE
指定掃描的類型。 此參數必須是 MPSCAN_TYPE 加入的其中一個成員。
-
dwScanOptions [in]
-
類型： DWORD
指定掃描工作的各種選項。
值 意義 - MPSCAN_OPTION_NONE
未要求任何特定選項。 - MPSCAN_OPTION_ASYNC
掃描工作是非同步， 其中 MpScanStart 會在成功開始掃描之後立即傳回。 (根據預設，掃描工作是同步的，這表示 MpScanStart 只會在掃描完成之後傳回。) - MPSCAN_OPTION_PROGRESS
呼叫端有興趣透過回呼接收掃描進度資訊。 - MPSCAN_OPTION_LOWPRIORITY
以低優先順序執行掃描。 (預設會以正常優先順序執行掃描工作。) - MPSCAN_OPTION_PACKEDEXES
掃描封裝的可執行檔是否有可能的威脅。 - MPSCAN_OPTION_ARCHIVES
掃描封存內容中是否有可能的威脅。 封存是副檔名為 .zip、.cab 或 .tar 等檔案。 - MPSCAN_OPTION_HEURISTICS
啟用啟發學習法型掃描。 這會掃描偵測類型設定為啟發學習法的威脅。 - MPSCAN_OPTION_REPORTFRIENDLY
報告資源掃描中的易記專案。 這僅供內部使用。 - MPSCAN_OPTION_REPORTUNKNOWN
報告資源掃描中的未知專案。 這僅供內部使用。 - MPSCAN_OPTION_NOCONSOLIDATE
請勿將掃描結果與全域威脅檢視合併。 這適用于用戶端 (，例如想要自行控制清除 UX 的電子郵件用戶端) ，而不是允許預設的反惡意程式碼清除 UX。 這僅供內部使用。 -
pScanResources [in， optional]
-
類型： PMPSCAN_RESOURCES
掃描資源資訊的指標。 此參數必須是 Null ，才能快速掃描。 這是完整掃描的選擇性參數。 針對資源掃描，必須以至少一個資源資訊結構來指定此參數。 若要掃描特定資源，呼叫端必須具有 資源GENERIC_READ 許可權。 請參閱 MPSCAN_RESOURCES。
-
pCallbackInfo [in， optional]
-
類型： PMPCALLBACK_INFO
用來將掃描狀態變更提供給用戶端的回呼資訊的指標， (例如開始和完成) 和進度資訊。 回呼函式中傳回 MPCALLBACK_DATA 會報告實際的掃描狀態和進度相關資訊。 以下是可能的回呼清單：
值 意義 - MPNOTIFY_SCAN_START
掃描工作已啟動。 - MPNOTIFY_SCAN_COMPLETE
掃描工作已完成。 其他資訊可透過 MPSCAN_DATA 結構取得。 - MPNOTIFY_SCAN_PAUSED
掃描工作已暫停。 - MPNOTIFY_SCAN_RESUMED
從暫停繼續掃描工作。 - MPNOTIFY_SCAN_CANCEL
掃描工作已取消。 - MPNOTIFY_SCAN_PROGRESS
掃描進度資訊。 (，例如資源統計資料) ，可透過 MPSCAN_DATA 結構取得其他資訊。 - MPNOTIFY_SCAN_ERROR
掃描特定資源的錯誤資訊。 特定資源資訊可透過 MPSCAN_DATA 結構取得。 - MPNOTIFY_SCAN_INFECTED
掃描發現受感染的資源。 請注意，在大部分情況下，這會導致在掃描結束時回報一些威脅。 有時候，它可能不會因為排除而具體化為威脅。 透過 MPSCAN_DATA 結構可取得其他受感染的資源資訊。 - MPNOTIFY_SCAN_MEMORYSTART
已啟動完整掃描的快速掃描部分。 - MPNOTIFY_SCAN_MEMORYCOMPLETE
完整掃描的快速掃描部分已完成。 - MPNOTIFY_INTERNAL_FAILURE
掃描工作發生一般失敗。 MPCALLBACK_DATA中的hResult具有特定的錯誤碼。 -
phScanHandle [out]
-
類型： PMPHANDLE
傳回的掃描控制碼，可識別目前起始的掃描。 此控制碼可用於後續的函式呼叫，例如擷取掃描結果。 必須使用 MpHandleClose 函式關閉控制碼。
傳回值
類型： HRESULT
如果函式成功，傳回值會 S_OK。
如果函式失敗，則傳回值是失敗 的 HRESULT 程式碼。 呼叫端可以使用 MpErrorMessageFormat 函式來取得錯誤訊息的一般描述。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|