次の方法で共有

ExpertIndicateStatus 関数

  • [アーティクル]

ExpertIndicateStatus 関数は、エキスパートによるキャプチャ ファイルの分析の完了率を示します。

構文

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

パラメーター

hExpertKey [in]

一意のエキスパート識別子。 Network Monitor は、Run 関数を呼び出すと、hExpertKey をエキスパートに渡します。

状態 [入力]

分析の現在の状態。 次のいずれかの EXPERTSTATUSENUMERATION 値を 指定します。

値 説明
EXPERTSTATUS_INACTIVE
 専門家は決して始めなかった。
EXPERTSTATUS_STARTING
 エキスパートが開始しています。
EXPERTSTATUS_RUNNING
 エキスパートは正常に実行されています。
EXPERTSTATUS_PROBLEM
 SubStatus パラメーターで指定された問題により、エキスパートが停止しました。
EXPERTSTATUS_ABORTED
 Network Monitor がエキスパートを停止しました。
EXPERTSTATUS_DONE
 エキスパートは分析を正常に完了しました。

SubStatus [in]

Status パラメーターによって提供される情報の拡張または明確化。

sztext [in]

オプションのテキスト状態インジケーター。

このパラメーター値は NULL である可能性があります。

PercentDone [out]

エキスパートが処理したキャプチャ データの割合。

エキスパートがキャプチャ ファイルの分析を正常に完了すると、パーセンテージが 100 に設定されます。 99 を超える数値は無視されます。

戻り値

関数が成功した場合、戻り値はNMERR_SUCCESS。

関数が失敗した場合、戻り値はNMERR_EXPERT_TERMINATE。エキスパートはすぐにクリーンし、キャプチャを完了せずに戻る必要があります。

解説

ExpertIndicateStatus 関数は、Run または Configure エクスポート関数を実装するエキスパートのみが呼び出すことができます。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Netmon.h
ライブラリ
Nmapi.lib
[DLL]
Nmapi.dll