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

Метод IMbnConnection::GetConnectionState (mbnapi.h)

  • Статья

Важно!

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

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

Синтаксис

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

Параметры

[out, retval] ConnectionState

Указатель на структуру MBN_ACTIVATION_STATE , содержащую состояние соединения.

[out, retval] ProfileName

Указатель на строку, содержащую имя профиля подключения. Этот параметр действителен, только если параметр ConnectionStateMBN_ACTIVATION_STATE_ACTIVATED. Если эта строка не имеет значение NULL, вызывающее приложение должно освободить эту строку, вызвав SysFreeString.

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.
Примечание Этот метод может возвращать S_OK, если ProfileName имеет значение NULL. Убедитесь, что клиент может обрабатывать значение NULLProfileName , даже если вызов выполнен успешно.
 
E_PENDING
 Состояние активации недоступно. Служба мобильной широкополосной связи проверит устройство на наличие информации. Вызывающее приложение может получать уведомления о доступности состояния активации, зарегистрировав метод OnConnectStateChangeобъекта IMbnConnectionEvents.
E_MBN_PIN_REQUIRED
 Для получения состояния вызова требуется ПИН-код.
E_MBN_SIM_NOT_INSERTED
 SIM-карта не вставляется в устройство.
E_MBN_BAD_SIM
 В устройство вставляется неправильная SIM-карта.

Комментарии

Этот метод может возвращать S_OK, если ProfileName имеет значение NULL. Убедитесь, что клиент может обрабатывать значение NULLProfileName , даже если вызов выполнен успешно.

Требования

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

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

IMbnConnection