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 |
|
| DLL |
|