Fonction ExpertIndicateStatus

  • Article

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

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