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 更新遇到签名下载问题,则可以将其用作回退选项。
MPUPDATE_OPTION_UNC
使用从 UNC 共享直接下载执行签名更新。
MPUPDATE_OPTION_MANAGED
使用托管服务 WSUS 执行签名更新。
MPUPDATE_OPTION_UNMANAGED
使用非托管服务 MU/WU 执行签名更新。

pCallbackInfo [in, 可选]

类型: 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 [仅限桌面应用]
标头
MpClient.h
DLL
MpClient.dll

另请参阅

MpErrorMessageFormat

MpHandleClose

MpManagerOpen

MPCALLBACK_DATA

MPSIGUPDATE_DATA