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

Метод IMbnConnectionProfileManager::GetConnectionProfiles (mbnapi.h)

  • Статья

Важно!

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

Возвращает список профилей подключений, связанных с устройством.

Синтаксис

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

Параметры

[in] mbnInterface

Интерфейс IMbnInterface, представляющий устройство, для которого применяется запрос профиля. Если это значение равно NULL, функция возвращает все профили, которые присутствуют в системе.

[out, retval] connectionProfiles

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

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.
E_HANDLE
 Недопустимый интерфейс, скорее всего, из-за того, что устройство мобильной широкополосной связи было удалено из системы.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
 Устройство не готово. Не удалось получить идентификатор подписчика, так как устройство не MBN_READY_STATE_INITIALIZED.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Служба мобильной широкополосной связи не работает в этой системе.

Комментарии

При вызове этой операции для конкретного устройства возвращается список профилей с тем же идентификатором подписчика, что и устройство. Метод GetSubscriberInformationобъекта IMbnInterface можно использовать для получения идентификатора подписчика, связанного с интерфейсом .

Профиль подключения связан с идентификатором подписчика устройства. Для устройств GSM идентификатором абонента является международный идентификатор мобильного абонента (IMSI) SIM-карты. Для устройств CDMA это строка мобильного идентификационного номера (MIN) или строка MIN в международном роуминге (IRM).

Требования

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

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

IMbnConnectionProfileManager