IStats::Connect 메서드
Connect 메서드는 지정된 NIC를 사용하여 NPP를 네트워크에 연결하고 연결에 대한 구성 정보를 제공합니다.
구문
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] LPVOID StatusCallbackProc,
[in] LPVOID UserContext,
[out] HBLOB hErrorBlob
);
매개 변수
-
hInputBlob [in]
-
NPP가 연결하는 NIC 및 해당 연결에 대한 구성 정보를 지정하는 BLOB에 대한 핸들입니다.
-
StatusCallbackProc [in]
-
트리거와 같은 상태 업데이트를 수신하는 사용자의 콜백 함수 주소입니다. 콜백 함수를 사용하지 않는 경우 이 매개 변수와 UserContext 매개 변수를 NULL로 설정합니다.
-
UserContext [in]
-
사용자의 콜백 함수가 호출될 때 전달되는 값입니다. 이 매개 변수의 값은 일반적으로 HWND 또는 'this' 포인터입니다. 콜백 함수를 지정하지 않으면 이 매개 변수와 StatusCallbackProc 매개 변수를 NULL로 설정합니다.
-
hErrorBlob [out]
-
추가 오류 정보가 포함된 오류 BLOB에 대한 핸들입니다.
반환 값
메서드가 성공하면 반환 값이 NMERR_SUCCESS.
메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다(내부 IStats::Configure 호출에서 반환된 오류를 포함).
| 반환 코드 | 설명 |
|---|---|
|
NPP COM 개체의 이 instance 이미 네트워크에 연결되어 있습니다. |
|
구성 BLOB이 손상되었습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
hInputBlob 매개 변수로 지정된 입력 BLOB에는 이 작업을 수행하는 데 필요한 항목이 없습니다. 이 오류는 IStats::Connect 또는 IStats::Configure 호출에 의해 생성될 수 있습니다.
hErrorBlob에서 반환된 BLOB 오류를 확인하여 찾을 수 없는 항목을 확인합니다. |
|
CreateBlob 함수가 호출되지 않았습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
문자열이 null로 종료되지 않습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
입력 BLOB의 트리거 부분이 손상되었습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
hInputBlob에 지정된 개체가 BLOB이 아닙니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
기본 캡처 디렉터리가 레지스트리에 설정되지 않았습니다. 캡처 디렉터리를 설정하려면 다음 경로를 사용합니다. |
|
이 작업을 수행하는 데 필요한 메모리를 사용할 수 없습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
요청 시간이 초과되었습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
|
hInputBlob에 지정된 BLOB의 버전 번호가 잘못되었습니다. 이 오류는 IStats::Configure 호출에 의해 생성됩니다. |
설명
Connect 메서드가 호출되면 네트워크 모니터는 hInputBlob 매개 변수에서 제공하는 BLOB을 사용하여 IStats::Configure 메서드를 자동으로 호출합니다. IStats::Configure 호출에서 반환된 오류 코드는 IStats::Connect 호출에서 다시 전달되고 반환됩니다.
프레임 캡처를 시작하려면 먼저 이 메서드를 호출해야 합니다. 이 방법을 사용하여 네트워크에 연결할 때는 IStats 인터페이스를 사용하여 프레임을 캡처해야 합니다.
hInputBlob으로 지정된 입력 BLOB은 GetNPPBlobFromUI, GetNPPBlobTable 및 SelectNPPBlobFromTable 메서드를 호출하여 가져올 수 있습니다.
hErrorBlob 매개 변수에서 반환된 오류 BLOB에는 네트워크 모니터가 hInputBlob에 지정된 입력 BLOB에서 이해하거나 찾을 수 없는 항목이 포함되어 있습니다. 반환된 오류 BLOB에는 애플리케이션이 문제 해결에 사용할 수 있는 오류 정보가 포함되어 있습니다. 예를 들어 NMERR_BLOB_ENTRY_DOES_NOT_EXIST 반환되면 네트워크 모니터에서 찾을 수 없는 항목이 반환된 오류 BLOB에 포함됩니다.
| 원하는 정보 | 참조 항목 |
|---|---|
| 네트워크 인터페이스를 나타내는 입력 BLOB 가져오기 카드 | 네트워크 인터페이스 카드 선택 |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|
| DLL |
|