Функция 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 [только классические приложения] |
Заголовок |
|
DLL |
|