MpScanStart fonction)

Démarre une opération d’analyse.

Syntaxe

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
);

Paramètres

hMpHandle [ dans]

Type : MPHANDLE

Handle de l’interface du gestionnaire de protection contre les programmes malveillants. Ce descripteur est retourné par la fonction MpManagerOpen .

ScanType [ dans]

Type : MPSCAN _

Spécifie le type d’analyse. Ce paramètre doit être l’un des membres du _ type MPSCAN enueration.

dwScanOptions [ dans]

Type : DWORD

Spécifie différentes options pour l’opération d’analyse.

Valeur Signification
_option MPSCAN _ None
Aucune option spécifique n’est demandée.
_option MPSCAN _ Async
L’opération d’analyse doit être asynchrone, où MpScanStart retourne immédiatement après l’initialisation réussie de l’analyse. (Par défaut, l’opération d’analyse est synchrone, ce qui signifie que MpScanStart ne retournera qu’une fois l’analyse terminée.)
progression de l' _ option MPSCAN _
L’appelant souhaite recevoir des informations sur la progression de l’analyse via un rappel.
_option MPSCAN _ LOWPRIORITY
Effectuez l’analyse avec une priorité basse. (Par défaut, l’opération d’analyse est effectuée avec une priorité normale.)
_option MPSCAN _ PACKEDEXES
Analyser les exécutables empaquetés pour détecter les menaces potentielles.
_Archives des options MPSCAN _
Analyser le contenu de l’Archive pour identifier les menaces potentielles. Les archives sont des fichiers avec des extensions telles que .zip, .cab ou. tar.
_heuristique des options MPSCAN _
Activez l’analyse heuristique. Cela permet de rechercher les menaces dont le type de détection est défini sur heuristiques.
_option MPSCAN _ REPORTFRIENDLY
Signaler les éléments conviviaux dans une analyse des ressources. Cela est destiné à un usage interne uniquement.
_option MPSCAN _ REPORTUNKNOWN
Signaler les éléments inconnus dans une analyse des ressources. Cela est destiné à un usage interne uniquement.
_option MPSCAN _ noconsolide
Ne Consolidez pas les résultats de l’analyse avec la vue globale des menaces. Cela est utile pour un client (tel qu’un client de messagerie) qui souhaite contrôler le nettoyage de l’expérience utilisateur par lui-même plutôt que d’autoriser l’expérience utilisateur de nettoyage anti-programme malveillant par défaut. Cela est destiné à un usage interne uniquement.

pScanResources [ dans, facultatif]

Type : _ ressources PMPSCAN

Pointeur vers les informations sur les ressources d’analyse. Ce paramètre doit avoir la valeur null pour une analyse rapide. Il s’agit d’un paramètre facultatif pour une analyse complète. Pour une analyse de ressource, ce paramètre doit être spécifié avec au moins une structure d’informations sur les ressources. Pour analyser des ressources spécifiques, l’appelant doit disposer de l’autorisation de _ lecture générique pour la ressource. Consultez _ ressources MPSCAN.

pCallbackInfo [ dans, facultatif]

Type : PMPCALLBACK _ info

Pointeur vers les informations de rappel utilisées pour alimenter le client avec les modifications de l’état d’analyse (par exemple, Start et Complete) et les informations de progression. Les _ données MPCALLBACK retournées dans la fonction de rappel signalent l’état d’analyse réel et les informations relatives à la progression. La liste suivante répertorie les rappels possibles :

Valeur Signification
début de l' _ analyse MPNOTIFY _
L’opération d’analyse a démarré.
_analyse MPNOTIFY _ terminée
L’opération d’analyse est terminée. Des informations supplémentaires sont disponibles via la structure de _ données MPSCAN .
_analyse MPNOTIFY _ suspendue
L’opération d’analyse est suspendue.
_analyse MPNOTIFY _ reprise
L’opération d’analyse a repris de la suspension.
annulation de l' _ analyse MPNOTIFY _
L’opération d’analyse a été annulée.
progression de l' _ analyse MPNOTIFY _
Analyser les informations de progression. Des informations supplémentaires (telles que les statistiques sur les ressources) sont disponibles via la structure de _ données MPSCAN .
_erreur d’analyse MPNOTIFY _
Analyser les informations d’erreur pour une ressource spécifique. Les informations de ressource spécifiques sont disponibles via la structure de _ données MPSCAN .
_analyse MPNOTIFY _ infectée
L’analyse a trouvé une ressource infectée. Notez que, dans la plupart des cas, cela entraînera une menace signalée à la fin de l’analyse. Parfois, il ne peut pas se matérialiser comme une menace en raison d’exclusions. Des informations supplémentaires sur les ressources infectées sont disponibles via la structure de _ données MPSCAN .
MPNOTIFY _ Scan _ MEMORYSTART
La partie analyse rapide de la totalité de l’analyse a démarré.
MPNOTIFY _ Scan _ MEMORYCOMPLETE
La partie analyse rapide de l’analyse complète est terminée.
_échec interne _ MPNOTIFY
L’opération d’analyse a rencontré un échec générique. Le HRESULT dans les _ données MPCALLBACK contient le code d’erreur spécifique.

phScanHandle [ à]

Type : PMPHANDLE

Handle d’analyse retourné qui identifie l’analyse actuellement lancée. Ce handle peut être utilisé dans les appels de fonction suivants, par exemple pour récupérer un résultat d’analyse. Le descripteur doit être fermé avec la fonction MpHandleClose .

Valeur de retour

Type : HRESULT

Si la fonction s’exécute correctement, la valeur de retour est _ OK.

Si la fonction échoue, la valeur de retour est un code HRESULT en échec. L’appelant peut utiliser la fonction MpErrorMessageFormat pour obtenir une description générique du message d’erreur.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8 [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [ applications de bureau uniquement]
En-tête
MpClient. h
DLL
MpClient.dll

Voir aussi

MpErrorMessageFormat

MpHandleClose

MpManagerOpen

_données MPCALLBACK

_données MPSCAN

_ressources MPSCAN

_type MPSCAN