Função MpUpdateStart
Inicia uma operação de atualização de assinatura.
Sintaxe
HRESULT WINAPI MpUpdateStart(
_In_ MPHANDLE hMpHandle,
_In_ DWORD dwUpdateOptions,
_In_opt_ PMPCALLBACK_INFO pCallbackInfo,
_Out_ PMPHANDLE phUpdateHandle
);
Parâmetros
-
hMpHandle [in]
-
Tipo: MPHANDLE
Manipule para a interface do gerenciador de proteção contra malware. Esse identificador é retornado pela função MpManagerOpen .
-
dwUpdateOptions [in]
-
Tipo: DWORD
Especifica a opção para a operação de atualização de assinatura. Pode ser um dos seguintes valores:
Valor Significado - MPUPDATE_OPTION_NONE
Nenhuma opção específica é solicitada. - MPUPDATE_OPTION_ASYNC
A operação de atualização deve ser assíncrona, em que MpUpdateStart retorna imediatamente após o início bem-sucedido da atualização de assinatura. (Por padrão, a operação de atualização é síncrona, o que significa que MpUpdateStart retornará somente após a conclusão da atualização da assinatura.) - MPUPDATE_OPTION_PROGRESS
O chamador está interessado em receber informações de progresso de atualização de assinatura por meio de um retorno de chamada. - MPUPDATE_OPTION_HTTP
A atualização de assinatura é executada baixando o pacote de assinatura completo do site do portal de segurança da Microsoft. Isso poderá ser usado como uma opção de fallback se o cliente estiver enfrentando um problema de download de assinatura por meio do Microsoft Update. - MPUPDATE_OPTION_UNC
Executa a atualização de assinatura usando o download direto de compartilhamentos UNC. - MPUPDATE_OPTION_MANAGED
Executa a atualização de assinatura usando o WSUS do Serviço Gerenciado. - MPUPDATE_OPTION_UNMANAGED
Executa a atualização de assinatura usando o MU/WU do Serviço Não Gerenciado. -
pCallbackInfo [in, opcional]
-
Tipo: PMPCALLBACK_INFO
Um ponteiro para as informações de retorno de chamada usadas para alimentar o cliente com alterações de estado de atualização de assinatura (como iniciar e concluir) e informações de progresso. O MPCALLBACK_DATA passado novamente na função de retorno de chamada relata o estado de atualização real e as informações relacionadas ao progresso. Veja a seguir uma lista de possíveis retornos de chamada:
Valor Significado - MPNOTIFY_SIGUPDATE_START
Operação de atualização iniciada. - MPNOTIFY_SIGUPDATE_COMPLETE
Operação de atualização concluída. - MPNOTIFY_SIGUPDATE_SEARCH_START
Pesquise por atualizações iniciadas. - MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE
Pesquise atualizações concluídas. Informações adicionais estão disponíveis por meio MPSIGUPDATE_DATA estrutura. - MPNOTIFY_SIGUPDATE_DOWNLOAD_START
Baixe para a atualização iniciada. - MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS
Baixar informações de progresso. Informações adicionais estão disponíveis por meio MPSIGUPDATE_DATA estrutura. - MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE
Baixe para a atualização concluída. Informações adicionais estão disponíveis por meio MPSIGUPDATE_DATA estrutura. - MPNOTIFY_SIGUPDATE_INSTALL_START
Instalação da atualização iniciada. - MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS
Informações de progresso da instalação. Informações adicionais estão disponíveis por meio MPSIGUPDATE_DATA estrutura. - MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE
Instalação da atualização concluída. Informações adicionais estão disponíveis por meio MPSIGUPDATE_DATA estrutura. - MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED
O serviço antimalware processou uma solicitação de atualização de assinatura. Falha ou êxito é indicado pelo hResult em MPCALLBACK_DATA. - MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
Requer reinicialização para concluir a operação de atualização. Falha ou êxito é indicado pelo hResult em MPCALLBACK_DATA. - MPNOTIFY_INTERNAL_FAILURE
A operação de atualização de assinatura encontrou uma falha genérica. O hResult no MPCALLBACK_DATA tem o código de erro específico. -
phUpdateHandle [out]
-
Tipo: PMPHANDLE
Identificador de atualização retornado que identifica a operação de atualização de assinatura iniciada no momento. Esse identificador pode ser usado em chamadas de função subsequentes, como para controlar a operação de atualização de assinatura. O identificador deve ser fechado com a função MpHandleClose .
Valor retornado
Tipo: HRESULT
Se a função for bem-sucedida, o valor retornado será S_OK.
Se a função falhar, o valor retornado será um código HRESULT com falha. O chamador pode usar a função MpErrorMessageFormat para obter uma descrição genérica da mensagem de erro.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2012 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|