IRTC::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 |
|