Метод IMbnRegistration::GetProviderID (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.
Возвращает идентификатор поставщика для зарегистрированной в настоящее время сети.
Синтаксис
HRESULT GetProviderID(
[out] BSTR *providerID
);
Параметры
[out] providerID
Указатель на строку, содержащую идентификатор зарегистрированного в настоящее время поставщика. Максимальная длина составляет MBN_PROVIDERID_LEN символов. Строка заполняется, только если метод возвращает S_OK для успешного выполнения. После успешного выполнения вызывающее приложение должно освободить выделенную память, вызвав SysFreeString.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Операция выполнена успешно. |
|
Идентификатор поставщика недоступен. Служба мобильной широкополосной связи в настоящее время проверит устройство на наличие информации. Когда идентификатор поставщика доступен, служба мобильной широкополосной связи вызовет метод OnRegisterModeAvailableобъекта IMbnRegistrationEvents. |
|
Для получения идентификатора поставщика требуется ПИН-код. |
|
SIM-карта не вставляется в устройство. |
|
В устройство вставляется неправильная SIM-карта. |
Комментарии
Метод GetProviderID получает идентификатор зарегистрированного в настоящее время поставщика. В режиме автоматического выбора сети это идентификатор сети, в которой в настоящее время зарегистрировано устройство. Если режим выбора сети выполняется вручную, это поле будет содержать идентификатор поставщика сети, в которой устройство будет пытаться зарегистрировать. Для устройств CDMA устанавливается значение MBN_CDMA_DEFAULT_PROVIDER_ID , если идентификатор поставщика неизвестен.
Эта информация может измениться при перемещении устройства мобильной широкополосной связи из одной сети в другую. Это включает в себя каждый раз, когда происходит изменение состояния MBN_REGISTER_STATE_HOME на MBN_REGISTER_STATE_SEARCHING в состоянии сетевой регистрации. Это также происходит при изменении зарегистрированной сети, например при перемещении регистрации от одного поставщика к другому. После таких изменений служба мобильного широкополосного подключения вызовет метод OnRegisterStateChangeобъекта IMbnRegistrationEvents. В этом случае приложение должно вызвать GetProviderID.
В случае E_MBN_PIN_REQUIRED ошибки с возможностью восстановления служба мобильного широкополосного подключения снова попытается получить эти сведения с устройства при завершении состояния ошибки (при вводе ПИН-кода). После этого служба мобильного широкополосного подключения вызовет метод OnPacketServiceStateChangeобъекта IMbnRegistrationEvents.
Требования
| Минимальная версия клиента | Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |