IRTC::QueryStations メソッド
QueryStations メソッドは、現在ネットワーク モニターを使用してネットワーク データをキャプチャしているすべてのコンピューターの一覧を提供します。
構文
HRESULT STDMETHODCALLTYPE QueryStations(
[in, out] QUERYTABLE *lpQueryTable
);
パラメーター
-
lpQueryTable [in, out]
-
QUERYTABLE 構造体へのポインター。 入力時に、この構造体には、Network Monitor から返されるコンピューターの最大数と STATIONQUERY 構造体の配列が含まれている必要があります。
出力時に、この構造体は、データをキャプチャするコンピューターの数と、検出された各コンピューターの STATIONQUERY 構造体を返します。 これには、バージョン 2.0 より前のバージョンの Network Monitor を使用するコンピューターが含まれる場合があることに注意してください。
戻り値
メソッドが成功した場合、戻り値は NMERR_SUCCESS。
メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
このクエリの処理に必要なメモリは使用できません。 |
解説
このメソッドは、 CreateNPPInterface メソッドが呼び出された後、いつでも呼び出すことができます。 このメソッドの呼び出しは同期呼び出しであり、ネットワーク モニターがリモート コンピューターがクエリに応答するのを待機している間に完了するまでに数秒かかる場合があります。 クエリを実行できるのは、ローカル サブネット上のコンピューターのみです。
ユーザーは 、QUERYTABLE 構造体のメモリを割り当て、テーブルが不要になった後、そのメモリを解放する必要があります。 この要件には、QUERYTABLE で使用される STATIONQUERY 配列に必要なメモリが含まれます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| [DLL] |
|