IMbnMultiCarrier::GetPreferredProviders 메서드(mbnapi.h)

다중 통신 사업자 디바이스의 현재 영역에 표시되는 구독된 공급자 목록을 가져오고 현재 등록된 공급자를 뺀 값입니다.

구문

HRESULT GetPreferredProviders(
  [out, retval] SAFEARRAY **preferredMulticarrierProviders
);

매개 변수

[out, retval] preferredMulticarrierProviders

기본 설정 공급자 목록을 포함하는 MBN_PROVIDER2 구조체 배열에 대한 포인터입니다. 이 메서드가 S_OK 이외의 값을 반환하는 경우 preferredMultiCarrierProviders 는 NULL입니다. GetPreferredProviders가 S_OK 반환하는 경우 호출 애플리케이션은 SafeArrayDestroy를 호출하여 할당된 메모리를 해제해야 합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

GetPreferredProviders 는 인터페이스의 기본 설정 공급자 목록에 저장된 공급자 목록을 반환합니다.

복구 가능한 오류 E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED 및 E_MBN_BAD_SIM 경우 모바일 광대역 서비스는 오류 조건이 끝나면 공급자 목록에 대해 디바이스를 다시 쿼리합니다. 예를 들어 공급자 목록을 가져오기 위해 디바이스에 PIN을 입력해야 하는 경우 GetPreferredProviders 는 E_MBN_PIN_REQUIRED 반환합니다. 애플리케이션이 디바이스의 잠금을 해제하기 위해 PIN에 들어가면 모바일 광대역 서비스가 디바이스에서 이 정보를 다시 가져옵니다.

복구 가능한 오류가 발생한 후 Windows가 디바이스를 쿼리하여 공급자 목록을 가져오는 경우 GetPreferredProviders 는 즉시 E_PENDING 반환합니다. 새 쿼리가 완료되면 적절한 콜백 메서드를 사용하여 호출 애플리케이션에 알림이 전송됩니다. 예를 들어 PIN 잠금 해제 작업이 성공하면 IMbnPinEvents의 OnEnterComplete 메서드가 호출됩니다.

모바일 광대역 서비스는 IMbnMultiCarrier의 OnPreferredProvidersChange 메서드를 호출하여 새 쿼리의 상태 대한 애플리케이션을 업데이트합니다.

경우에 따라 SMS 또는 OTA(무선 업데이트)를 통해 디바이스의 기본 공급자 목록을 네트워크를 통해 업데이트할 수 있습니다. Windows는 IMbnMultiCarrier의 OnPreferredProvidersChange 메서드를 호출하여 기본 설정 공급자 목록의 변경 내용을 애플리케이션에 알립니다.

사용자가 여러 구독(둘 이상)을 사용하거나 디바이스가 기본 설정 네트워크에 대해 미리 프로비전되어 있고 네트워크의 적용 범위 영역에 있는 경우 기본 제공자 목록을 사용할 수 있습니다. 이 목록은 사용자가 여러 네트워크를 구독하고 해당 적용 범위 영역 밖에 있는 경우에도 비어 있을 수 있습니다. 이 목록에는 현재 등록된 네트워크를 제외하고 사용자가 구독했거나 디바이스가 미리 프로비전한 현재 표시되는 모든 네트워크가 포함됩니다.

프로비전하면 다중 통신 사업자 디바이스의 기존 기본 설정 목록에 새 홈 공급자가 추가될 수도 있습니다. 이는 SetHomeProvider를 사용하여 수행됩니다.

요구 사항

참고 항목

IMbnMultiCarrier