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 である必要があります。 これは、フル スキャンの省略可能なパラメーターです。 リソース スキャンの場合、このパラメーターは少なくとも 1 つのリソース情報構造で指定する必要があります。 特定のリソースをスキャンするには、呼び出し元にリソース 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 [デスクトップ アプリのみ] |
| Header |
|
| [DLL] |
|