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

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

  • Статья

Важно!

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

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

Синтаксис

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

Параметры

[in] mbnInterface

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

[in] profileName

Строка, заканчивающаяся null, которая содержит имя профиля подключения.

[out, retval] connectionProfile

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

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

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

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

Комментарии

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

Если новый профиль был создан с помощью CreateConnectionProfile, вызывающий объект должен дождаться получения события OnConnectionProfileArrival, прежде чем вызывать GetConnectionProfile с именем нового профиля; В противном случае вызов API GetConnectionProfile может завершиться ошибкой HRESULT_FROM_WIN32(ERROR_NOT_FOUND).

Требования

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

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

IMbnConnectionProfileManager