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

另请参阅

MpErrorMessageFormat

MpHandleClose

MpManagerOpen

MPCALLBACK_DATA

MPSIGUPDATE_DATA