Fonction ExpertIndicateStatus

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

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]

Status 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 fonctionne 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 status 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 l’analyse d’un fichier de capture, le système définit le pourcentage sur 100. Tout 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 propre 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’exportation Exécuter ou configurer .

Spécifications