次の方法で共有

IStats::QueryStations メソッド

  • [アーティクル]

QueryStations メソッドは、ネットワーク モニターを使用して現在データをキャプチャしているすべてのコンピューターの一覧を提供します。

構文

HRESULT STDMETHODCALLTYPE QueryStations(
  [in, out] QUERYTABLE *lpQueryTable
);

パラメーター

lpQueryTable [in, out]

QUERYTABLE 構造体へのポインター。 入力時に、この構造体には、Network Monitor から返されるコンピューターの最大数と STATIONQUERY 構造体の配列が含まれている必要があります。

出力時に、この構造体は、データをキャプチャしているコンピューターの数と、検出された各コンピューターの STATIONQUERY 構造体を返します。 この情報には、バージョン 2.0 より前のバージョンの Network Monitor を使用するコンピューターが含まれる場合があることに注意してください。

戻り値

メソッドが成功した場合、戻り値はNMERR_SUCCESS。

メソッドが失敗した場合、戻り値は次のエラー コードになります。

リターン コード 説明
NMERR_OUT_OF_MEMORY
 このクエリの処理に必要なメモリが使用できませんでした。

解説

このメソッドは、 CreateNPPInterface が呼び出された後、いつでも呼び出すことができます。 このメソッドの呼び出しは同期呼び出しであり、ネットワーク モニターがリモート コンピューターがクエリに応答するまで待機するため、完了するまでに数秒かかる場合があります。 クエリを実行できるのは、ローカル サブネット上のコンピューターのみです。

QUERYTABLE 構造体にメモリを割り当て、テーブルが不要になった後でそのメモリを解放するのはユーザーの責任です。 この要件には、QUERYTABLE で使用される STATIONQUERY 配列に必要なメモリが含まれます。

要件

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

関連項目

IStats

QUERYTABLE

STATIONQUERY