IMbnInterface::GetSubscriberInformation 메서드(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

구독자 정보를 가져옵니다.

구문

HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation
);

매개 변수

[out, retval] subscriberInformation

디바이스에 대한 구독자 정보를 포함하는 IMbnSubscriberInformation 인터페이스의 주소에 대한 포인터입니다. 이 메서드가 S_OK 이외의 값을 반환하는 경우 이 매개 변수는 NULL입니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 완료되었습니다. subscriberInformation 에는 유효한 인터페이스가 포함되어 있습니다.
E_PENDING	정보를 사용할 수 없습니다. 모바일 광대역 서비스는 현재 정보를 검색하고 있습니다. IMbnInterfaceEvents의 OnSubscriberInformationChange 메서드에 등록하여 정보를 사용할 수 있는 경우 호출 애플리케이션에 알림을 받을 수 있습니다.

설명

GetSubscriberInformation 메서드는 구독자 ID, SIM 국제 회로 카드 번호 및 이 인터페이스와 연결된 전화 번호를 포함하여 구독자 관련 정보를 반환합니다.

이 메서드는 통신사 권한이 있는 Windows 스토어 앱에서 호출될 때 SimIccID 속성에 정의된 SIM International 회로 카드 번호만 반환합니다.

구독자 정보에 반환된 값 중 일부는 IMbnInterface의 GetReadyState 메서드에서 보고한 준비 상태가 MBN_READY_STATE_INITIALIZED 경우에만 채워집니다. 모바일 광대역 디바이스와 연결된 구독자 정보가 변경될 때마다 모바일 광대역 서비스는 IMbnInterfaceEvents의 OnSubscriberInformationChange 메서드를 호출하여 등록된 애플리케이션에 알립니다.

디바이스 준비 상태가 MBN_READY_STATE_INITIALIZED 디바이스에 대한 구독자 정보는 변경되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mbnapi.h

추가 정보

IMbnInterface