IMbnInterfaceEvents::OnScanNetworkComplete 메서드(mbnapi.h)

이 알림 방법은 모바일 광대역 서비스에서 네트워크 검사 완료를 나타내기 위해 호출됩니다.

구문

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 메서드를 호출하여 표시되는 공급자 목록을 가져올 수 있습니다.

알림을 위해 등록된 여러 애플리케이션이 있는 경우 등록된 모든 애플리케이션에서 이 메서드가 호출됩니다. 즉, 업데이트 작업을 시작하지 않은 애플리케이션은 알림을 받습니다.

요구 사항

참고 항목

IMbnInterfaceEvents