MpUpdateStart fonction)

Démarre une opération de mise à jour de signature.

Syntaxe

HRESULT WINAPI MpUpdateStart(
  _In_     MPHANDLE         hMpHandle,
  _In_     DWORD            dwUpdateOptions,
  _In_opt_ PMPCALLBACK_INFO pCallbackInfo,
  _Out_    PMPHANDLE        phUpdateHandle
);

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 .

dwUpdateOptions [ dans]

Type : DWORD

Spécifie l’option pour l’opération de mise à jour des signatures. Ce peut être l’une des valeurs suivantes :

Valeur Signification
_option mise à jour _ None
Aucune option spécifique n’est demandée.
_option mise à jour _ Async
L’opération de mise à jour doit être asynchrone, où MpUpdateStart retourne immédiatement après l’initialisation réussie de la mise à jour de la signature. (Par défaut, l’opération de mise à jour est synchrone, ce qui signifie que MpUpdateStart retournera uniquement une fois la mise à jour de signature terminée.)
progression de l' _ option mise à jour _
L’appelant souhaite recevoir des informations de progression de mise à jour de signature via un rappel.
_option mise à jour _ http
La mise à jour de signature est effectuée en téléchargeant le package de signature complète à partir du site portail de sécurité Microsoft. Cela peut être utilisé comme option de secours si le client rencontre un problème de téléchargement de signature via Microsoft Update.
_option mise à jour _ UNC
Effectue une mise à jour de signature à l’aide du téléchargement direct à partir de partages UNC.
_option mise à jour _ gérée
Effectue une mise à jour de signature à l’aide du service managé WSUS.
_option mise à jour _ non gérée
Effectue une mise à jour de signature à l’aide du service non managé MU/WU.

pCallbackInfo [ dans, facultatif]

Type : PMPCALLBACK _ info

Pointeur vers les informations de rappel utilisées pour alimenter le client avec les modifications de l’état de mise à jour de signature (telles que le début et la fin) et les informations de progression. Les _ données MPCALLBACK retournées dans la fonction de rappel signalent l’état de mise à jour réel et les informations relatives à la progression. La liste suivante répertorie les rappels possibles :

Valeur Signification
MPNOTIFY _ SIGUPDATE _ Start
L’opération de mise à jour a démarré.
MPNOTIFY _ SIGUPDATE _ terminé
Opération de mise à jour terminée.
début de la _ recherche MPNOTIFY SIGUPDATE _ _
Recherche des mises à jour démarrées.
recherche de MPNOTIFY _ SIGUPDATE _ _ terminée
Recherche des mises à jour terminées. Des informations supplémentaires sont disponibles via la structure de _ données MPSIGUPDATE .
démarrage du téléchargement de MPNOTIFY _ SIGUPDATE _ _
Téléchargement de la mise à jour démarré.
progression du téléchargement de MPNOTIFY _ SIGUPDATE _ _
Télécharger les informations de progression. Des informations supplémentaires sont disponibles via la structure de _ données MPSIGUPDATE .
Téléchargement de MPNOTIFY _ SIGUPDATE _ _ terminé
Téléchargement pour la mise à jour terminée. Des informations supplémentaires sont disponibles via la structure de _ données MPSIGUPDATE .
démarrage de l’installation de MPNOTIFY _ SIGUPDATE _ _
L’installation de la mise à jour a démarré.
progression de l’installation de MPNOTIFY _ SIGUPDATE _ _
Informations de progression de l’installation. Des informations supplémentaires sont disponibles via la structure de _ données MPSIGUPDATE .
installation de MPNOTIFY _ SIGUPDATE _ _ terminée
Installation de la mise à jour terminée. Des informations supplémentaires sont disponibles via la structure de _ données MPSIGUPDATE .
_requête MPNOTIFY _ SIGUPDATE _ traitée
Le service anti-programme malveillant a traité une demande de mise à jour de signature. L’échec ou la réussite est indiqué par HRESULT dans les _ données de MPCALLBACK.
redémarrage de MPNOTIFY _ SIGUPDATE _ _ requis
Nécessite un redémarrage pour terminer l’opération de mise à jour. L’échec ou la réussite est indiqué par HRESULT dans les _ données de MPCALLBACK.
_échec interne _ MPNOTIFY
L’opération de mise à jour de signature a rencontré un échec générique. Le HRESULT dans les _ données MPCALLBACK contient le code d’erreur spécifique.

phUpdateHandle [ à]

Type : PMPHANDLE

Handle de mise à jour retourné qui identifie l’opération de mise à jour de signature actuellement lancée. Ce handle peut être utilisé dans les appels de fonction suivants, par exemple, pour contrôler l’opération de mise à jour de signature. 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 MPSIGUPDATE