IMbnInterfaceEvents::OnScanNetworkComplete 메서드(mbnapi.h)
중요
Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.
이 알림 방법은 모바일 광대역 서비스에서 네트워크 검사 완료를 나타내기 위해 호출됩니다.
구문
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
매개 변수
[in] newInterface
이 작업이 수행된 디바이스를 나타내는 IMbnInterface 입니다.
[in] requestID
이 알림에 대해 모바일 광대역 서비스에서 할당한 요청 ID입니다.
[in] status
작업 완료 상태
호출 애플리케이션은 다음 값 중 하나를 예상할 수 있습니다.
S_OK
작업이 완료되었습니다.
E_MBN_RADIO_POWER_OFF
디바이스 라디오가 꺼져 있으므로 표시되는 네트워크 목록을 가져올 수 없습니다. 애플리케이션은 라디오 켜기 알림을 받으면 네트워크 검사 요청을 실행할 수 있습니다.
E_MBN_DEVICE_BUSY
디바이스가 사용 중이며 현재 네트워크 검사 작업을 수행할 수 없습니다. 데이터 연결이 설정된 경우 네트워크 검사 작업을 지원하지 않는 디바이스에서 반환됩니다.
E_MBN_ALREADY_ACTIVE
네트워크 검사 작업이 이미 진행 중입니다.
반환 값
이 메서드는 S_OK 반환해야 합니다.
설명
작업이 성공적으로 완료되면, 즉 상태 S_OK 경우 모바일 광대역 서비스는 표시되는 공급자의 캐시된 목록을 성공적으로 업데이트했습니다. 그런 다음, 애플리케이션은 전달된 IMbnInterface의 GetVisibleProviders 메서드를 호출하여 표시되는 공급자 목록을 가져올 수 있습니다.
알림을 위해 등록된 여러 애플리케이션이 있는 경우 등록된 모든 애플리케이션에서 이 메서드가 호출됩니다. 즉, 업데이트 작업을 시작하지 않은 애플리케이션은 알림을 받습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | mbnapi.h |