Поделиться через


Метод IMbnInterface::GetSubscriberInformation (mbnapi.h)

Важно!

Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.

Возвращает сведения о подписчике.

Синтаксис

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

Параметры

[out, retval] subscriberInformation

Указатель на адрес интерфейса IMbnSubscriberInformation , который содержит сведения о подписчике для устройства. Если этот метод возвращает любое значение, отличное от S_OK, этот параметр имеет значение NULL.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
Метод завершился успешно. subscriberInformation содержит допустимый интерфейс.
E_PENDING
Сведения недоступны. Служба мобильной широкополосной связи в настоящее время проверит информацию. Вызывающее приложение может получать уведомления о доступности сведений, зарегистрировав метод OnSubscriberInformationChangeобъекта IMbnInterfaceEvents.

Комментарии

Метод GetSubscriberInformation возвращает сведения, связанные с подписчиком, включая идентификатор подписчика, международный канал SIM-карты карта номер и номера телефонов, связанные с этим интерфейсом.

При вызове этого метода из приложения Магазина Windows с привилегиями мобильного оператора он возвращает только канал SIM International карта номер, определенный свойством SimIccID.

Некоторые значения, возвращаемые в сведениях о подписчике, заполняются только в том случае, если состояние готовности, о котором сообщает метод GetReadyStateIMbnInterface, MBN_READY_STATE_INITIALIZED. При изменении сведений о подписчике, связанных с устройством мобильной широкополосной связи, служба мобильной широкополосной связи будет уведомлять зарегистрированные приложения путем вызова метода OnSubscriberInformationChangeобъекта IMbnInterfaceEvents.

Сведения о подписчике для устройства не изменятся после MBN_READY_STATE_INITIALIZED состояния готовности устройства.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mbnapi.h

См. также раздел

IMbnInterface