Метод IMbnInterface::GetHomeProvider (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.
Возвращает поставщика домашней службы.
Синтаксис
HRESULT GetHomeProvider(
[out, retval] MBN_PROVIDER *homeProvider
);
Параметры
[out, retval] homeProvider
Указатель на структуру MBN_PROVIDER , представляющую домашнего поставщика. Если этот метод возвращает любое значение, отличное от S_OK, этот параметр имеет значение NULL. После завершения вызывающее приложение должно освободить память, выделенную членам providerID и providerNameMBN_PROVIDER путем вызова SysFreeString.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. homeProvider содержит допустимые значения. |
|
Сведения недоступны. Служба мобильной широкополосной связи в настоящее время проверит, чтобы получить домашнего поставщика. Вызывающее приложение может получать уведомления о доступности домашнего поставщика, зарегистрировав метод OnHomeProviderAvailableIMbnInterfaceEvents. |
|
Устройство требует, чтобы для этой операции был введен ПИН-код. |
|
SIM-карта не вставляется. |
|
В устройство вставляется неправильная SIM-карта. |
|
Не удается выполнить чтение из SIM-карты или памяти устройства. Например, sim-карта не имеет подготовленных сведений о домашнем поставщике. |
Комментарии
GetHomeProvider возвращает сведения о домашнем поставщике для устройства. Поле dataClass возвращаемой структуры MBN_PROVIDER следует игнорировать.
Для ошибок, которые можно исправить E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED и E_MBN_BAD_SIM, служба мобильного широкополосного подключения снова запросит у устройства домашнего поставщика по завершении условия ошибки. Например, если устройство требует ввода ПИН-кода для получения этих сведений, оно вернет E_MBN_PIN_REQUIRED. Когда приложение вводит ПИН-код для разблокировки устройства, служба мобильной широкополосной связи снова попытается получить эти сведения с устройства. Система обновит приложение о состоянии нового запроса, вызвав метод OnHomeProviderAvailableобъекта IMbnInterfaceEvents.
Зарегистрированный метод OnHomeProviderAvailableIMbnInterfaceEvents можно вызвать при наличии сведений о домашнем поставщике или при выполнении нового запроса с ошибкой. После того как эта функция возвращает успешное выполнение, эта информация никогда не изменится.
Требования
| Минимальная версия клиента | Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |