MpUpdateStart 関数
署名の更新操作を開始します。
構文
HRESULT WINAPI MpUpdateStart(
_In_ MPHANDLE hMpHandle,
_In_ DWORD dwUpdateOptions,
_In_opt_ PMPCALLBACK_INFO pCallbackInfo,
_Out_ PMPHANDLE phUpdateHandle
);
パラメーター
-
hMpHandle [in]
-
種類: MPHANDLE
マルウェア保護マネージャー インターフェイスに対処します。 このハンドルは、 MpManagerOpen 関数によって返されます。
-
dwUpdateOptions [in]
-
型: DWORD
署名更新操作のオプションを指定します。 次のいずれかの値を指定できます。
値 説明 - MPUPDATE_OPTION_NONE
特定のオプションは要求されません。 - MPUPDATE_OPTION_ASYNC
更新操作は非同期であり、 MpUpdateStart はシグネチャの更新が正常に開始された直後にを返します。 (既定では、更新操作は同期です。つまり、 MpUpdateStart は署名の更新が完了した後にのみを返します)。 - MPUPDATE_OPTION_PROGRESS
呼び出し元は、コールバックを介して署名更新の進行状況情報を受信することに関心があります。 - MPUPDATE_OPTION_HTTP
署名の更新は、Microsoft セキュリティ ポータル サイトから完全な署名パッケージをダウンロードすることによって実行されます。 これは、クライアントで Microsoft Update 経由で署名のダウンロードの問題が発生している場合にフォールバック オプションとして使用できます。 - MPUPDATE_OPTION_UNC
UNC 共有からの直接ダウンロードを使用して署名の更新を実行します。 - MPUPDATE_OPTION_MANAGED
Managed Service WSUS を使用して署名の更新を実行します。 - MPUPDATE_OPTION_UNMANAGED
アンマネージド サービス MU/WU を使用して署名の更新を実行します。 -
pCallbackInfo [in, optional]
-
種類: PMPCALLBACK_INFO
署名更新状態の変更 (開始や完了など) と進行状況情報をクライアントに提供するために使用されるコールバック情報へのポインター。 コールバック関数で返される MPCALLBACK_DATA は、実際の更新状態と進行状況に関連する情報を報告します。 可能なコールバックの一覧を次に示します。
値 説明 - MPNOTIFY_SIGUPDATE_START
更新操作が開始されました。 - MPNOTIFY_SIGUPDATE_COMPLETE
更新操作が完了しました。 - MPNOTIFY_SIGUPDATE_SEARCH_START
開始された更新プログラムを検索します。 - MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE
完了した更新プログラムを検索します。 追加情報は、 MPSIGUPDATE_DATA 構造を介して入手できます。 - MPNOTIFY_SIGUPDATE_DOWNLOAD_START
更新プログラムのダウンロードが開始されました。 - MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS
進行状況情報をダウンロードします。 追加情報は、 MPSIGUPDATE_DATA 構造を介して入手できます。 - MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE
ダウンロードして更新を完了します。 追加情報は、 MPSIGUPDATE_DATA 構造を介して入手できます。 - MPNOTIFY_SIGUPDATE_INSTALL_START
更新プログラムのインストールが開始されました。 - MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS
インストールの進行状況に関する情報。 追加情報は、 MPSIGUPDATE_DATA 構造を介して入手できます。 - MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE
更新プログラムのインストールが完了しました。 追加情報は、 MPSIGUPDATE_DATA 構造を介して入手できます。 - MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED
マルウェア対策サービスが署名更新要求を処理しました。 失敗または成功は、MPCALLBACK_DATAの hResult によって示されます。 - MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
更新操作を完了するには再起動が必要です。 失敗または成功は、MPCALLBACK_DATAの hResult によって示されます。 - MPNOTIFY_INTERNAL_FAILURE
シグネチャの更新操作で一般的なエラーが発生しました。 MPCALLBACK_DATAの hResult には、特定のエラー コードがあります。 -
phUpdateHandle [out]
-
種類: PMPHANDLE
現在開始されている署名更新操作を識別する更新ハンドルが返されます。 このハンドルは、シグネチャ更新操作の制御など、後続の関数呼び出しで使用できます。 ハンドルは MpHandleClose 関数で閉じる必要があります。
戻り値
種類: HRESULT
関数が成功した場合、戻り値は S_OK。
関数が失敗した場合、戻り値は失敗した HRESULT コードです。 呼び出し元は MpErrorMessageFormat 関数を使用して、エラー メッセージの一般的な説明を取得できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2012 [デスクトップ アプリのみ] |
| Header |
|
| [DLL] |
|