Fonction ExpertIndicateStatus

  • Article
  • 2 minutes de lecture

La fonction ExpertIndicateStatus indique le pourcentage d’achèvement de l’analyse de l’expert du fichier de capture.

Syntaxe

DWORD WINAPI ExpertIndicateStatus(
  _In_  HEXPERTKEY              hExpertKey,
  _In_  EXPERTSTATUSENUMERATION Status,
  _In_  DWORD                   SubStatus,
  _In_  char                    *sztext,
  _Out_ long                    PercentDone
);

Paramètres

hExpertKey [in]

Identificateur d’expert unique. Network Monitor transmet hExpertKey à l’expert lorsqu’il appelle la fonction Run .

État [in]

État actuel de l’analyse. Spécifiez l’une des valeurs EXPERTSTATUSENUMERATION suivantes.

Valeur Signification
EXPERTSTATUS_INACTIVE
 L’expert n’a jamais commencé.
EXPERTSTATUS_STARTING
 L’expert commence.
EXPERTSTATUS_RUNNING
 L’expert s’exécute normalement.
EXPERTSTATUS_PROBLEM
 Un problème spécifié dans le paramètre SubStatus a arrêté l’expert.
EXPERTSTATUS_ABORTED
 Network Monitor a arrêté l’expert.
EXPERTSTATUS_DONE
 L’expert a terminé l’analyse avec succès.

SubStatus [in]

Extension ou clarification des informations fournies par le paramètre Status .

sztext [in]

Indicateur d’état du texte facultatif.

Cette valeur de paramètre peut être NULL.

PercentDone [out]

Pourcentage des données de capture traitées par l’expert.

Lorsque l’expert termine correctement l’analyse d’un fichier de capture, le système définit le pourcentage sur 100. Un nombre supérieur à 99 est ignoré.

Valeur retournée

Si la fonction réussit, la valeur de retour est NMERR_SUCCESS.

Si la fonction échoue, la valeur de retour est NMERR_EXPERT_TERMINATE; l’expert doit immédiatement nettoyer et retourner sans terminer la capture.

Notes

La fonction ExpertIndicateStatus ne peut être appelée que par des experts qui implémentent la fonction d’exécution ou de configuration de l’exportation.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Netmon.h
Bibliothèque
Nmapi.lib
DLL
Nmapi.dll