IStats::GetConversationStatistics メソッド
GetConversationStatistics メソッドは、現在のキャプチャに関するセッション情報とステーション情報を取得します。
構文
HRESULT STDMETHODCALLTYPE GetConversationStatistics(
[out] DWORD *nSessions,
[out] LPSESSIONSTATS lpSessionStats,
[out] DWORD *nStations,
[out] LPSTATIONSTATS lpStationStats,
[in] BOOL fClearAfterReading
);
パラメーター
-
nSessions [out]
-
現在のキャプチャ用に記録された セッション の数を含む DWORD へのポインター。
-
lpSessionStats [out]
-
SESSIONSTATS 構造体へのポインター。
-
nStations [out]
-
現在のキャプチャ用に記録された ステーション の数を含む DWORD へのポインター。
-
lpStationStats [out]
-
STATIONSTATS 構造体へのポインター。
-
fClearAfterReading [in]
-
現在のデータが取得された後、 SESSIONSTATS および STATIONSTATS 構造体の内部ストレージをクリアするようにネットワーク モニターに指示するために使用されるフラグ。
戻り値
メソッドが成功した場合、戻り値はNMERR_SUCCESS。
メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
NPP がネットワークに接続されていません。
IStats::Connect を呼び出して、NPP をネットワークに接続します。 |
|
NPP はデータをキャプチャしていません。
IStats::Start を呼び出してキャプチャを開始します。 |
|
NPP はネットワークに接続されていますが、 IStats::Connect メソッドでは接続されません。 |
|
この接続の構成は、会話統計を保存しないように設定されています。 会話統計を保存するには、キャプチャを停止し、構成 BLOB で NoConversationStats = YES を設定してから、キャプチャを再起動します。 |
解説
このメソッドは、データ キャプチャの進行中にのみ呼び出すことができます。現在のキャプチャが一時停止されている場合、このメソッドの呼び出しは成功しません。
キャプチャを開始するには、 IStats::Start メソッドを呼び出します。 他の種類の統計を取得するには、 IStats::GetTotalStatistics を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| [DLL] |
|