Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы SystemConfiguration ссылка CaptiveNetwork

Опции
Развертывание Target:

На этой странице

Ссылка CaptiveNetwork

Наследование

Не применимый

Соответствует

Не применимый

Оператор импорта

Не применимый

Objective C

@import SystemConfiguration;

CaptiveNetwork интерфейс программирования позволяет приложению взаимодействовать с Присоединенной Сетевой поддержкой, системный компонент, ответственный за обнаружение сетей, требующих взаимодействия с пользователем прежде, чем обеспечить доступ в Интернет. Эти сети являются обычно точками доступа Wi-Fi в общедоступных расположениях, таких как аэропорты и отели.

Путем вызова CNSetSupportedSSIDs функция, приложение может зарегистрировать список беспроводной сети SSIDs с Присоединенной Сетевой поддержкой, таким образом приняв на себя ответственность за аутентификацию с теми сетями. Обычно, когда пользователь присоединяется к присоединенной сети, Присоединенная Сетевая поддержка обеспечивает веб-лист, позволяющий пользователю аутентифицировать с сетью. Если приложение зарегистрировало SSID присоединенной сети, однако, веб-лист подавлен, и пользователь может завершить аутентификацию в надлежащем приложении.

После того, как пользователь выполняет аутентификацию в приложении, зарегистрировавшем SSID, приложение должно сообщить Присоединенной Сетевой поддержке результата аутентификации с любым CNMarkPortalOnline функционируйте или CNMarkPortalOffline функция.

Функции

Регистрация SSIDs
  • CNSetSupportedSSIDs

    Указывает обновленный список присоединенной сети SSIDs, на которой приложение выполняет аутентификацию.

    Объявление

    Objective C

    Boolean CNSetSupportedSSIDs ( CFArrayRef ssidArray );

    Параметры

    ssidArray

    Массив CFString объекты, представляющие SSIDs поддержка приложений.

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

    TRUE если успешно обновляется список; иначе, FALSE.

    Обсуждение

    Список ведется столько, сколько установлено приложение.

    Обеспечение нового списка заменяет любой более ранний список, который обеспечило приложение.

    Оператор импорта

    Objective C

    @import SystemConfiguration;

    Доступность

    Доступный в iOS 4.0 и позже.

Создание отчетов о результатах аутентификации
  • CNMarkPortalOnline

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

    Объявление

    Objective C

    Boolean CNMarkPortalOnline ( CFStringRef interfaceName );

    Параметры

    interfaceName

    Имя интерфейса, который является теперь онлайновым.

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

    TRUE если успешно выполнилась работа; иначе, FALSE.

    Оператор импорта

    Objective C

    @import SystemConfiguration;

    Доступность

    Доступный в iOS 4.0 и позже.

  • CNMarkPortalOffline

    Сообщает Присоединенной Сетевой поддержке, что устройство не аутентифицируется в присоединенной сети.

    Объявление

    Objective C

    Boolean CNMarkPortalOffline ( CFStringRef interfaceName );

    Параметры

    interfaceName

    Имя интерфейса, который является теперь оффлайновым.

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

    TRUE если успешно выполнилась работа; иначе, FALSE.

    Оператор импорта

    Objective C

    @import SystemConfiguration;

    Доступность

    Доступный в iOS 4.0 и позже.

Получение информации о сети
  • CNCopyCurrentNetworkInfo

    Возвращает текущую информацию о сети для данного сетевого интерфейса.

    Объявление

    Objective C

    CFDictionaryRef CNCopyCurrentNetworkInfo ( CFStringRef interfaceName );

    Параметры

    interfaceName

    Сетевой интерфейс.

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

    Словарь, содержащий текущую информацию о сети интерфейса. Владение соблюдает Создать Правило.

    Оператор импорта

    Objective C

    @import SystemConfiguration;

    Доступность

    Доступный в iOS 4.1 и позже.

  • CNCopySupportedInterfaces

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

    Объявление

    Objective C

    CFArrayRef CNCopySupportedInterfaces ( void );

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

    Имена сетевого интерфейса, как массив CFStringRef объекты. Владение соблюдает Создать Правило.

    Оператор импорта

    Objective C

    @import SystemConfiguration;

    Доступность

    Доступный в iOS 4.1 и позже.

Константы

  • Ключи информации о сети

    Ключи, соответствующие значениям в словаре информации о сети, полученном с CNCopyCurrentNetworkInfo функция.

    Объявление

    Objective C

    const CFStringRef kCNNetworkInfoKeyBSSID; const CFStringRef kCNNetworkInfoKeySSID; const CFStringRef kCNNetworkInfoKeySSIDData;

    Константы

    • kCNNetworkInfoKeyBSSID

      Ключ для BSSID сети, представленного как a CFStringRef объект.

      Доступный в iOS 4.1 и позже.

    • kCNNetworkInfoKeySSID

      Ключ для SSID сети, представленного как a CFStringRef объект.

      Доступный в iOS 4.1 и позже.

    • kCNNetworkInfoKeySSIDData

      Ключ для SSID сети, представленного как a CFDataRef объект.

      Доступный в iOS 4.1 и позже.