ExpertIndicateStatus-Funktion

Die ExpertIndicateStatus-Funktion gibt den Prozentsatz des Abschlusses der Analyse der Erfassungsdatei durch den Experten an.

Syntax

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

Parameter

hExpertKey [ In]

Eindeutiger Expertenbezeichner. Netzwerkmonitor übergibt hExpertKey an den Experten, wenn er die Run-Funktion aufruft.

Status [ In]

Aktueller Status der Analyse. Geben Sie einen der folgenden EXPERTSTATUSENUMERATION-Werte an.

Wert Bedeutung
EXPERTSTATUS _ INACTIVE
Der Experte hat nie begonnen.
EXPERTSTATUS _ STARTING
Der Experte beginnt.
EXPERTSTATUS _ WIRD AUSGEFÜHRT
Der Experte wird normal ausgeführt.
_EXPERTSTATUS-PROBLEM
Ein im SubStatus-Parameter angegebenes Problem hat den Experten beendet.
EXPERTSTATUS _ ABGEBROCHEN
Netzwerkmonitor beendete den Experten.
EXPERTSTATUS _ DONE
Der Experte hat die Analyse erfolgreich abgeschlossen.

SubStatus [ In]

Erweiterung oder Erläuterung der informationen, die vom Status-Parameter bereitgestellt werden.

sztext [ In]

Optionaler Textstatusindikator.

Dieser Parameterwert kann NULL sein.

PercentDone [ out]

Prozentsatz der Erfassungsdaten, die der Experte verarbeitet hat.

Wenn der Experte die Analyse einer Erfassungsdatei erfolgreich abgeschlossen hat, legt das System den Prozentsatz auf 100 fest. Jede Zahl, die größer als 99 ist, wird ignoriert.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet der Rückgabewert NMERR _ SUCCESS.

Wenn die Funktion nicht erfolgreich ist, lautet der Rückgabewert NMERR _ EXPERT _ TERMINATE. Der Experte muss sofort bereinigen und zurückgeben, ohne die Erfassung abzuschließen.

Hinweise

Die ExpertIndicateStatus-Funktion kann nur von Experten aufgerufen werden, die die Exportfunktion Ausführen oder Konfigurieren implementieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Netmon.h
Bibliothek
Nmapi.lib
DLL
Nmapi.dll