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
使用受控服務 WSUS 執行簽章更新。 - MPUPDATE_OPTION_UNMANAGED
使用 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 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|