IESP::QueryStations 方法
QueryStations方法會提供目前使用網路監視器來擷取網路資料的所有電腦清單。
語法
HRESULT STDMETHODCALLTYPE QueryStations(
[in, out] QUERYTABLE *lpQueryTable
);
參數
-
lpQueryTable [in, out]
-
QUERYTABLE結構的指標。 在輸入時,此結構必須包含您希望網路監視器傳回的電腦數目上限,以及 STATIONQUERY 結構的陣列。
在輸出時,此結構會傳回擷取資料的電腦數目,以及每部找到之電腦的 STATIONQUERY 結構。 請注意,此總計可能包含使用版本 2.0 之前的網路監視器電腦。
傳回值
如果方法成功,傳回值會NMERR_SUCCESS。
如果方法失敗,傳回值會是下列錯誤碼:
傳回碼 | 描述 |
---|---|
|
無法處理此查詢所需的記憶體。 |
備註
呼叫 CreateNPPInterface 方法之後,您可以隨時呼叫這個方法。 呼叫此方法是同步呼叫,可能需要幾秒鐘的時間才能完成,因為網路監視器會等候遠端電腦回應查詢。 只能查詢本機子網上的電腦。
您必須負責為 QUERYTABLE 結構配置記憶體,並在不再需要資料表之後釋放該記憶體。 這項需求包括 QUERYTABLE 中使用的 STATIONQUERY 陣列所需的記憶體。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
標頭 |
|
DLL |
|