IDelaydC::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] |
|