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

Метод IMbnRegistration::GetProviderName (mbnapi.h)

  • Статья

Важно!

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

Возвращает имя поставщика для зарегистрированной в настоящее время сети.

Синтаксис

HRESULT GetProviderName(
  [out] BSTR *providerName
);

Параметры

[out] providerName

Указатель на строку, содержащую имя зарегистрированного в данный момент поставщика. Максимальная длина этой строки составляет MBN_PROVIDERNAME_LEN символов. Строка заполняется, только если метод возвращает S_OK для успешного выполнения. После успешного выполнения вызывающее приложение должно освободить выделенную память, вызвав SysFreeString.

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

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

Код возврата Описание
S_OK
 Операция выполнена успешно.
E_PENDING
 Имя поставщика недоступно. Служба мобильной широкополосной связи в настоящее время проверит устройство на наличие информации. Если имя поставщика доступно, служба мобильной широкополосной связи вызовет метод OnRegisterModeAvailableобъекта IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED
 Для получения имени поставщика требуется ПИН-код.
E_MBN_SIM_NOT_INSERTED
 SIM-карта не вставляется в устройство.
E_MBN_BAD_SIM
 В устройство вставляется неправильная SIM-карта.

Комментарии

Имя поставщика может измениться при перемещении устройства мобильной широкополосной связи из одной сети в другую. Это относится к каждому изменению состояния MBN_REGISTER_STATE_HOME на MBN_REGISTER_STATE_SEARCHING в состоянии регистрации сети. Это также происходит при изменении зарегистрированной сети, например при изменении регистрации сети от одного поставщика к другому. После таких изменений служба мобильной широкополосной связи вызовет метод OnRegisterStateChangeобъекта IMbnRegistrationEvents. В этом случае приложение должно вызвать GetProviderID.

Для E_MBN_PIN_REQUIRED ошибки, которая может быть устранена, служба мобильной широкополосной связи попытается повторно получить эти сведения с устройства при завершении состояния ошибки (при вводе ПИН-кода). Затем он вызовет метод OnRegisterStateChangeобъекта IMbnRegistrationEvents.

Требования

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

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

IMbnRegistration