Функция 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
Обновление подписи выполняется путем скачивания полного пакета подписи с сайта портала безопасности Майкрософт. Это можно использовать в качестве резервного варианта, если у клиента возникла проблема с загрузкой подписи через Центр обновления Майкрософт.
MPUPDATE_OPTION_UNC
Выполняет обновление подписи с помощью прямого скачивания из общих папок UNC.
MPUPDATE_OPTION_MANAGED
Выполняет обновление подписи с помощью служб WSUS управляемой службы.
MPUPDATE_OPTION_UNMANAGED
Выполняет обновление сигнатуры с помощью неуправляемого многоуправляемого интерфейса или центра обновления службы.

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
Служба защиты от вредоносных программ обработала запрос на обновление подписи. Сбой или успех обозначается hResult в MPCALLBACK_DATA.
MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
Для завершения операции обновления требуется перезагрузка. Сбой или успех обозначается hResult в MPCALLBACK_DATA.
MPNOTIFY_INTERNAL_FAILURE
Операция обновления сигнатуры привела к универсальному сбою. HResult в MPCALLBACK_DATA имеет конкретный код ошибки.

phUpdateHandle [out]

Тип: PMPHANDLE

Возвращен дескриптор обновления, который идентифицирует текущую операцию обновления сигнатуры. Этот дескриптор можно использовать в последующих вызовах функций, например для управления операцией обновления сигнатуры. Дескриптор должен быть закрыт с помощью функции MpHandleClose .

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, возвращается значение S_OK.

Если функция завершается сбоем, возвращается код HRESULT . Вызывающий объект может использовать функцию MpErrorMessageFormat , чтобы получить общее описание сообщения об ошибке.

Требования

Требование Значение
Минимальная версия клиента
Windows 8 [только классические приложения]
Минимальная версия сервера
Windows Server 2012 [только классические приложения]
Заголовок
MpClient.h
DLL
MpClient.dll

См. также раздел

MpErrorMessageFormat

MpHandleClose

MpManagerОткрыть

MPCALLBACK_DATA

MPSIGUPDATE_DATA