Função MpScanStart

Inicia uma operação de digitalização.

Sintaxe

HRESULT WINAPI MpScanStart(
  _In_     MPHANDLE          hMpHandle,
  _In_     MPSCAN_TYPE       ScanType,
  _In_     DWORD             dwScanOptions,
  _In_opt_ PMPSCAN_RESOURCES pScanResources,
  _In_opt_ PMPCALLBACK_INFO  pCallbackInfo,
  _Out_    PMPHANDLE         phScanHandle
);

Parâmetros

hMpHandle [em]

Tipo: MPHANDLE

Manipule a interface do gerenciador de proteção contra malware. Esse identificador é retornado pela função MpManagerOpen .

ScanType [em]

Tipo: MPSCAN_TYPE

Especifica o tipo de verificação. Este parâmetro deve ser um dos membros da enumeração MPSCAN_TYPE .

dwScanOptions [em]

Tipo: DWORD

Especifica várias opções para a operação de varredura.

Valor	Significado
MPSCAN_OPTION_NONE	Nenhuma opção específica é solicitada.
MPSCAN_OPTION_ASYNC	A operação de verificação deve ser assíncrona, onde MpScanStart retorna imediatamente após o início bem-sucedido da verificação. (Por padrão, a operação de verificação é síncrona, o que significa que o MpScanStart retornará somente depois que a verificação for concluída.)
MPSCAN_OPTION_PROGRESS	O chamador está interessado em receber informações sobre o progresso da varredura por meio de um retorno de chamada.
MPSCAN_OPTION_LOWPRIORITY	Execute a verificação com baixa prioridade. (Por padrão, a operação de verificação é executada com prioridade normal.)
MPSCAN_OPTION_PACKEDEXES	Analise executáveis compactados em busca de possíveis ameaças.
MPSCAN_OPTION_ARCHIVES	Analise o conteúdo do arquivo em busca de possíveis ameaças. Arquivos são arquivos com extensões como .zip, .cabou .tar.
MPSCAN_OPTION_HEURISTICS	Habilite a verificação baseada em heurística. Isso verificará ameaças com o tipo de deteção definido como heurística.
MPSCAN_OPTION_REPORTFRIENDLY	Relatar itens amigáveis em uma verificação de recursos. Destina-se apenas a uso interno.
MPSCAN_OPTION_REPORTUNKNOWN	Relatar itens desconhecidos em uma verificação de recursos. Destina-se apenas a uso interno.
MPSCAN_OPTION_NOCONSOLIDATE	Não consolide os resultados da verificação com a visualização de ameaças globais. Isso é útil para um cliente (como um cliente de e-mail) que deseja controlar a UX de limpeza por si só, em vez de permitir a UX de limpeza antimalware padrão. Destina-se apenas a uso interno.

pScanResources [em, opcional]

Tipo: PMPSCAN_RESOURCES

Um ponteiro para as informações do recurso de verificação. Este parâmetro deve ser NULL para uma verificação rápida. Este é um parâmetro opcional para uma verificação completa. Para uma verificação de recursos, esse parâmetro deve ser especificado com pelo menos uma estrutura de informações de recurso. Para verificar recursos específicos, o chamador deve ter GENERIC_READ permissão para o recurso. Ver MPSCAN_RESOURCES.

pCallbackInfo [em, 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 verificação (como início e conclusão) e informações de progresso. O MPCALLBACK_DATA passado de volta na função de retorno de chamada relata o estado real da verificação e informações relacionadas ao progresso. A seguir está uma lista de possíveis retornos de chamada:

Valor	Significado
MPNOTIFY_SCAN_START	Operação de verificação iniciada.
MPNOTIFY_SCAN_COMPLETE	Operação de verificação concluída. Informações adicionais estão disponíveis através MPSCAN_DATA estrutura.
MPNOTIFY_SCAN_PAUSED	A operação de verificação é pausada.
MPNOTIFY_SCAN_RESUMED	A operação de verificação foi retomada da pausa.
MPNOTIFY_SCAN_CANCEL	A operação de verificação foi cancelada.
MPNOTIFY_SCAN_PROGRESS	Verificar informações de progresso. Informações adicionais (como estatísticas de recursos) estão disponíveis através MPSCAN_DATA estrutura.
MPNOTIFY_SCAN_ERROR	Verificar informações de erro para um recurso específico. As informações específicas do recurso estão disponíveis através MPSCAN_DATA estrutura.
MPNOTIFY_SCAN_INFECTED	A verificação encontrou um recurso infetado. Observe que, na maioria dos casos, isso resultará em alguma ameaça relatada no final da verificação. Às vezes, pode não se materializar como uma ameaça por causa de exclusões. Informações adicionais sobre recursos infetados estão disponíveis por meio de MPSCAN_DATA estrutura.
MPNOTIFY_SCAN_MEMORYSTART	A parte de verificação rápida da verificação completa foi iniciada.
MPNOTIFY_SCAN_MEMORYCOMPLETE	A parte de verificação rápida da verificação completa foi concluída.
MPNOTIFY_INTERNAL_FAILURE	A operação de verificação encontrou uma falha genérica. O hResult em MPCALLBACK_DATA tem o código de erro específico.

phScanHandle [saída]

Tipo: PMPHANDLE

Alça de verificação retornada que identifica a verificação iniciada no momento. Esse identificador pode ser usado em chamadas de função subsequentes, como para recuperar um resultado de verificação. A alça deve ser fechada com a função MpHandleClose .

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, o valor de retorno será S_OK.

Se a função falhar, o valor de retorno 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.

Requerimentos

Ver também

MpErrorMessageFormat

MpHandleClose

MpManagerOpen

MPCALLBACK_DATA

MPSCAN_DATA

MPSCAN_RESOURCES

MPSCAN_TYPE