Создание ссылки

SCNetworkReachability API обеспечивает три функции, создающие целевую ссылку, которую можно использовать для контроля достижимости удаленного узла:

• SCNetworkReachabilityCreateWithAddress

• SCNetworkReachabilityCreateWithAddressPair

• SCNetworkReachabilityCreateWithName

Если Вы интересуетесь достижимостью только удаленного узла, можно использовать также SCNetworkReachabilityCreateWithAddress или SCNetworkReachabilityCreateWithName. Для SCNetworkReachabilityCreateWithAddress, Вы предоставляете удаленный адрес узла в a sockaddr структура. Для получения дополнительной информации о sockaddr структура, посмотрите сети man страница в http://developer .apple.com/documentation/Darwin/Reference/ManPages/man4/netintro.4.html. Для SCNetworkReachabilityCreateWithName, Вы предоставляете удаленное имя хоста, такое как www.apple.com.

Если необходимо наблюдать возможные изменения и к локальным и к удаленным адресам узла, Вы используете SCNetworkReachabilityCreateWithAddressPair функция. Эта функция возвращает ссылку, которую можно использовать, чтобы узнать если:

• Адрес Ваших локальных изменений узла

• Удаленный адрес становится недостижимым

• Сетевой маршрут связался с удаленными изменениями узла

Все три функции возвращают объект типа SCNetworkReachabilityRef для удаленного узла, который можно использовать в любой из других функций SCNetworkReachability.

Добавление Target к циклу выполнения

Гарантировать, что Ваше приложение получает уведомление, когда состояние достижимости целевых удаленных изменений узла, Вы добавляете цель SCNetworkReachabilityRef к циклу выполнения Вашего приложения. Цикл выполнения контролирует источники ввода к приложению. Когда входной источник становится готовым к обработке (потому что некоторое действие происходит), управление отгрузками цикла выполнения к функции обратного вызова, связанной с входным источником. Для получения дополнительной информации о выполненных циклах и режимах, посмотрите Циклы Выполнения.

Для сетевого осведомленного приложения входной источник SCNetworkReachabilityRef, действие является изменением в состоянии соединения цели, и функция обратного вызова является той, которую Вы обеспечиваете. Таким образом, при помощи достижимости API, чтобы добавить Вашу цель к циклу выполнения Вашего приложения и обеспечить функцию обратного вызова (описанный в Соединении Функции обратного вызова С Target), Вы гарантируете, что Ваше приложение будет уведомлено относительно изменений в достижимости цели.

Добавить SCNetworkReachabilityRef к циклу выполнения Вашего приложения Вы используете SCNetworkReachabilityScheduleWithRunLoop функция. Вы обеспечиваете SCNetworkReachabilityRef, ссылка на цикл выполнения Вашего приложения и режим, в котором цикл выполнения должен работать, обычно режим по умолчанию.

Удалить SCNetworkReachabilityRef от цикла выполнения Вашего приложения Вы используете SCNetworkReachabilityUnscheduleFromRunLoop функция, требующая тех же параметров как SCNetworkReachabilityScheduleWithRunLoop функция.

Соединение функции обратного вызова с Target

Для использования уведомлений достижимость, API обеспечивает, необходимо связать функцию обратного вызова с SCNetworkReachabilityRef при представлении удаленного узла Вы интересуетесь. Функция обратного вызова могла бы вывести на экран изменение в соединении с пользователем или выполнить некоторую другую задачу.

Для соединения функции обратного вызова с целью Вы сначала определяете функцию типа SCNetworkReachabilityCallBack (этот тип определяется в SCNetworkReachability.h). Для передачи контекстной информации об изменениях в функции обратного вызова Вы определяете структуру типа SCNetworkReachabilityContext. Вы используете info параметр для содержания контекстной информации (можно также указать NULL, если контекстная информация является ненужной). Наконец, Вы передаете функцию обратного вызова, SCNetworkReachabilityRef представление удаленного узла и контекста к SCNetworkReachabilitySetCallback функция.

Определение достижимости

SCNetworkReachability API обеспечивает SCNetworkReachabilityGetFlags функция можно использовать для определения достижимости удаленного узла. Эти предоставления функции то же состояние соединения отмечают более старые функции, определяемые достижимости в SCNetwork.h предоставленный.

Для использования этой функции Вы предоставляете SCNetworkReachabilityRef для Вашего удаленного узла и адреса переменной Вы объявляете для содержания флагов. Флаги, которые можно получить, перечислены в Таблице 4-1.

Создание ссылки соединения

SCNetworkConnection API обеспечивает одну функцию, которую можно использовать для создания ссылки соединения: SCNetworkConnectionCreateWithServiceID. Для использования этой функции Вы предоставляете службу ID и функцию обратного вызова, вместе с несколькими другими параметрами, и Вы получаете объект типа SCNetworkConnectionRef. Вы используете этот объект представлять соединение в других функциях SCNetworkConnection.

Поскольку Вы будете использовать SCNetworkConnectionRef для обращения к определенному соединению PPP необходимо предоставить уникальную службу ID для идентификации его. Существует два способа получить эту службу ID. Один путь состоит в том, чтобы посмотреть в динамической памяти для доступных служб и выбрать ту. Второй путь для Вашего приложения для использования SCNetworkConnectionCopyUserPreferences функция для получения службы ID по умолчанию (та интернет-использование приложения Подключения).

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

Добавление ссылки соединения на цикл выполнения

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

Добавить SCNetworkConnectionRef к циклу выполнения Вашего приложения Вы используете SCNetworkConnectionScheduleWithRunLoop функция. Вы обеспечиваете SCNetworkConnectionRef, ссылка на цикл выполнения Вашего приложения и режим, в котором цикл выполнения должен работать (в большинстве случаев, режим по умолчанию). Для получения дополнительной информации о выполненных циклах и режимах, посмотрите Введение для Выполнения Циклов в Базовой Ссылочной Библиотеке Основы.

Удалить SCNetworkConnectionRef от цикла выполнения Вашего приложения Вы используете SCNetworkConnectionUnscheduleFromRunLoop функция. Как SCNetworkConnectionScheduleWithRunLoop функция, эта функция ожидает SCNetworkConnectionRef, ссылка на цикл выполнения Вашего приложения и режим цикла выполнения.

Запуск и остановка соединения

SCNetworkConnection API обеспечивает две функции, которые Ваше приложение может использовать для управления соединением с помощью SCNetworkConnectionRef объект:

• SCNetworkConnectionStart

• SCNetworkConnectionStop

Обе функции возвращаются сразу, в то время как соединение или разъединение обрабатывают, они инициируют доходы асинхронно. Если Вы добавляете соединение SCNetworkConnectionRef к циклу выполнения Вашего приложения и обеспечивают функцию обратного вызова, Ваше приложение уведомляется, когда изменяется состояние соединения. Ваше приложение может тогда проверить состояние, чтобы определить, завершен ли процесс соединения. Если Вы не добавляете ссылку соединения на цикл выполнения, необходимо будет опросить для обнаружения состояния соединения, и это не рекомендуется.

По умолчанию, SCNetworkConnectionStart функционируйте использует предпочтительные настройки подключения пользователя для запуска соединения. Можно, однако, обеспечить словарь значений для переопределения некоторых из этих настроек на время соединения.

Если Вы действительно обеспечиваете, словарь дополнительных настроек знают что:

• Словарь должен быть в правильном формате для словаря сетевой службы (описан в Словаре NetworkServices). Если Вы не следуете за этим форматом точно, контроллер PPP может проигнорировать словарь.

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

Запуск и остановка соединения неявно решены в арбитражном порядке. Это означает, что интерес, который другие приложения могут иметь в соединении, учтен, прежде чем соединение останавливается. Например, приложение «B» может запустить соединение, уже запущенное приложением «A». Приложение можение принимает решение остановить соединение, но система не должна останавливать соединение до «B», закончено с ним. Используя функции SCNetworkConnection, приложение вызов банки SCNetworkConnectionStop на соединении и функции возвратит успех, но соединение не остановится до «B» вызовы SCNetworkConnectionStop. Приложение может также использовать linger параметр (обсужденный ниже) для регистрации интереса.

SCNetworkConnectionStart функция позволяет приложению указывать интерес к соединению. Таким образом приложение может запросить, чтобы существование соединения было связано к мерам, которые принимает приложение. В самом простом случае приложение могло бы хотеть, чтобы соединение запустилось, когда приложение вызывает SCNetworkConnectionStart и остановитесь, когда любое из следующих событий будет иметь место:

• Выходы приложения.

• Приложение выпускает SCNetworkConnectionRef представление соединения.

• Вызовы приложения SCNetworkConnectionStop.

Для указания интереса к соединению приложение может использовать linger параметр SCNetworkConnectionStart функция. Приложение, такое как почтовый клиент, который должен быть соединен, выполняет свои задачи и разъединяется, устанавливает параметр на FALSE. Это указывает, что соединение должно остановиться, когда приложение выходит или выпускает ссылку соединения. Приложение номеронабирателя PPP, с другой стороны, могло бы принять решение установить параметр на TRUE так, чтобы пользователь управлял модемом. TRUE значение указывает, что соединение не должно останавливаться, когда приложение выходит или выпускает ссылку соединения.

Важно отметить, однако, что несколько параллельных приложений могли бы зарегистрировать интерес к тому же соединению. Когда дело обстоит так, платформа Конфигурации системы отслеживает ссылки на соединение, останавливая его, когда последняя ссылка выпущена (или последнее приложение, содержащее ссылку, выходит).

SCNetworkConnectionStop функция выполняет решенную в арбитражном порядке остановку соединения. Другими словами, это закрывает соединение если:

• Нет никаких других заинтересованных приложений, в настоящее время работающих или содержащих ссылки на соединение. Если существует, SCNetworkConnectionStop функционируйте успех возвратов к вызывающему приложению, но соединение сохранится, пока все заинтересованные приложения не завершают или выпускают свои ссылки на соединение.

• Приложение вызывает SCNetworkConnectionStop и передачи TRUE в forceDisconnect параметр. Это останавливает соединение независимо от интереса других в настоящее время запущенных приложений. Большинство приложений не должно вынуждать соединение остановиться таким образом. Приложение номеронабирателя PPP, однако, вероятно приняло бы решение сделать это, потому что оно гарантирует, что соединение останавливается, когда пользователь хочет его к.

Получение состояния соединения

Приложение может использовать SCNetworkConnectionGetStatus функция для получения высокоуровневого состояния соединения. Вы передаете SCNetworkConnectionRef при представлении соединения с функцией и Вы получаете одну из констант, показанных во Введении в Инструкции по Программированию Конфигурации системы.

Если Ваше приложение должно знать больше о соединении PPP, такой как тогда, когда контроллер PPP аутентифицирует к серверу, необходимо использовать SCNetworkConnectionCopyExtendedStatus функция. Вы передаете SCNetworkConnectionRef при представлении соединения с функцией и Вы получаете словарь, содержащий подсловари для каждого субкомпонента службы, такие как PPP, IPv4 и Модем. Состояние соединения PPP представлено константой, определенной в SCNetworkConnection API. Таблица 4-3 показывает текущий набор констант. Обратите внимание на то, что дополнительные значения состояния могли бы быть определены в будущем, таким образом, Ваше приложение должно быть в состоянии обработать неизвестное значение.

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