Compartilhar via


Função MpScanControl

Permite o controle de uma verificação que foi iniciada de forma assíncrona por meio de MpScanStart.

Sintaxe

HRESULT WINAPI MpScanControl(
  _In_ MPHANDLE  hScanHandle,
  _In_ MPCONTROL ScanControl
);

Parâmetros

hScanHandle [in]

Tipo: MPHANDLE

Manipule para uma operação de verificação assíncrona. Esse identificador é retornado pela função MpScanStart . Esse parâmetro também pode ser definido como o identificador de interface do gerenciador de proteção contra malware retornado pela função MpManagerOpen para controlar uma verificação iniciada pelo sistema, nesse caso, o chamador deve ter privilégio administrativo.

ScanControl [in]

Tipo: MPCONTROL

Especifica uma opção de controle de verificação. Esse parâmetro deve ser uma das seguintes opções de controle:

Valor Significado
MPCONTROL_ABORT
Anular a operação de verificação.
MPCONTROL_PAUSE
Pause a operação de verificação.
MPCONTROL_RESUME
Retomar a operação de verificação pausada.

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
MpClient.h
DLL
MpClient.dll

Confira também

MpErrorMessageFormat

MpManagerOpen

MpScanStart