Ссылка CFNetServices

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

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

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

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

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

Swift

import CFNetwork

Objective C

@import CFNetwork;

CFNetServices API является частью Добрый день, реализацией Apple нулевой конфигурации, объединяющей (ZEROCONF) в сеть. CFNetServices API позволяет Вам регистрировать сетевую службу, такую как сервер принтера или файловый сервер, так, чтобы это могло быть найдено по имени или просмотрено для типом службы и доменом. Приложения могут использовать CFNetServices API для обнаружения служб, которые доступны в сети и найти всю информацию о доступе — такую как имя, IP-адрес, и номер порта — должен был использовать каждую службу.

В действительности Добрый день регистрация и открытие комбинируют функции локального сервера DNS и AppleTalk, позволяя приложениям обеспечить вид удобного для пользователя просмотра, доступного в Селекторе AppleTalk, использующем открытые протоколы, такие как Многоадресная передача DNS (mDNS). Добрый день предоставляет легкий доступ приложений к службам по локальным сетям IP, не требуя, чтобы служба поддерживала штабель AppleTalk, и не требуя сервера DNS в локальной сети.

Для полного описания Добрый день, см. Добрый день Обзор.

Функции

Создание объектов сетевой службы


    
    CFNetServiceCreate (_: _: _: _: _:)
    CFNetServiceCreate

Создает экземпляр объекта Сетевой службы.

Объявление

Swift

func CFNetServiceCreate(_ alloc: CFAllocator!, _ domain: CFString!, _ type: CFString!, _ name: CFString!, _ port: Int32) -> Unmanaged<CFNetService>!

Objective C

CFNetServiceRef CFNetServiceCreate ( CFAllocatorRef alloc, CFStringRef domain, CFStringRef serviceType, CFStringRef name, SInt32 port );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`domain`	Домен, в котором должен быть зарегистрирован CFNetService; не может быть `NULL`. Вызвать `CFNetServiceBrowserCreate` и `CFNetServiceBrowserSearchForDomains` получить регистрационный домен.
`type`	Тип зарегистрированной службы; не может быть `NULL`. Для списка допустимых типов службы посмотрите http://www .iana.org/assignments/port-numbers.
`name`	Уникальное имя, если экземпляр будет использоваться для регистрации службы. Имя станет частью имени экземпляра в записях DNS, которые будут создаваться, когда будет зарегистрирована служба. Если экземпляр будет использоваться для разрешения службы, имя должно быть именем машины или службы, которая будет разрешена.
`port`	Локальный порт IP, в порядке байтов узла, на котором эта служба принимает соединения. Нуль передачи для получения службы заполнителя. Со службой заполнителя служба не будет обнаружена путем просмотра, но конфликт имен произойдет, если другой клиент попытается зарегистрировать то же имя. Большинство приложений не должно использовать службу заполнителя.

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

Новый объект сетевой службы, или NULL если не мог бы быть создан экземпляр. Владение соблюдает Создать Правило.

Обсуждение

Если служба зависит от информации в DNS записи TXT, вызвать CFNetServiceSetProtocolSpecificInformation.

Если CFNetService должен работать в асинхронном режиме, вызвать CFNetServiceSetClient подготавливать службу к выполнению в асинхронном режиме. Тогда вызовите CFNetServiceScheduleWithRunLoop запланировать службу на цикл выполнения. Тогда вызовите CFNetServiceRegister сделать службу доступной.

Если CFNetService должен работать в синхронном режиме, вызвать CFNetServiceRegister.

Для завершения службы, работающей в асинхронном режиме вызвать CFNetServiceCancel и CFNetServiceUnscheduleFromRunLoop.

Для завершения службы, работающей в синхронном режиме вызвать CFNetServiceCancel.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceCreateCopy (_: _:)
    CFNetServiceCreateCopy

Создает копию объекта CFNetService.

Объявление

Swift

func CFNetServiceCreateCopy(_ alloc: CFAllocator!, _ service: CFNetService!) -> Unmanaged<CFNetService>!

Objective C

CFNetServiceRef CFNetServiceCreateCopy ( CFAllocatorRef alloc, CFNetServiceRef service );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`service`	CFNetServiceRef, который будет скопирован; не может быть `NULL`. Если `service` не допустимый CFNetServiceRef, поведение этой функции не определено.

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

Копия service, включение всех ранее разрешенных данных, или NULL если service не мог быть скопирован. Владение соблюдает Создать Правило.

Обсуждение

Эта функция создает копию CFNetService, указанного service.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceMonitorCreate (_: _: _: _:)
    CFNetServiceMonitorCreate

Создает экземпляр объекта NetServiceMonitor что часы для рекордных изменений.

Объявление

Swift

func CFNetServiceMonitorCreate(_ alloc: CFAllocator!, _ theService: CFNetService!, _ clientCB: CFNetServiceMonitorClientCallBack, _ clientContext: UnsafeMutablePointer<CFNetServiceClientContext>) -> Unmanaged<CFNetServiceMonitor>!

Objective C

CFNetServiceMonitorRef CFNetServiceMonitorCreate ( CFAllocatorRef alloc, CFNetServiceRef theService, CFNetServiceMonitorClientCallBack clientCB, CFNetServiceClientContext *clientContext );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theService`	CFNetService, который будет контролироваться.
`clientCB`	Указатель на функцию обратного вызова, которую нужно вызвать, когда запись связалась с `theService` изменения; не может быть `NULL`.
`clientContext`	Указатель на определяемую пользователем контекстную информацию, которая должна быть передана обратному вызову, указанному `clientCB` когда вызывают обратный вызов; не может быть `NULL`. Для получения дополнительной информации посмотрите CFNetServiceClientContext.

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

Новый экземпляр CFNetServiceMonitor, или NULL если не мог бы быть создан монитор. Владение соблюдает Создать Правило.

Обсуждение

Эта функция создает CFNetServiceMonitor, наблюдающий за изменениями в записях, связанных с theService.

Если CFNetServiceMonitor должен работать в асинхронном режиме, вызвать CFNetServiceMonitorScheduleWithRunLoop запланировать монитор на цикл выполнения. Тогда вызовите CFNetServiceMonitorStart начинать контролировать. Когда изменение происходит, функция обратного вызова, указанная clientCB будет вызван. Для получения дополнительной информации посмотрите CFNetServiceMonitorClientCallBack.

Если CFNetServiceMonitor должен работать в синхронном режиме, вызвать CFNetServiceMonitorStart.

Для остановки монитора, работающего в асинхронном режиме вызвать CFNetServiceMonitorStop и CFNetServiceMonitorUnscheduleFromRunLoop.

Для остановки монитора, работающего в синхронном режиме вызвать CFNetServiceMonitorStop.

Если Вы больше не должны наблюдать рекордные изменения, вызвать CFNetServiceMonitorStop остановить монитор и затем вызвать CFNetServiceMonitorInvalidateлишить законной силы монитор, таким образом, это не может использоваться снова. Тогда вызовите CFRelease выпускать память связалось с CFNetServiceMonitorRef.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceBrowserCreate (_: _: _:)
    CFNetServiceBrowserCreate

Создает экземпляр объекта браузера Сетевой службы.

Объявление

Swift

func CFNetServiceBrowserCreate(_ alloc: CFAllocator!, _ clientCB: CFNetServiceBrowserClientCallBack, _ clientContext: UnsafeMutablePointer<CFNetServiceClientContext>) -> Unmanaged<CFNetServiceBrowser>!

Objective C

CFNetServiceBrowserRef CFNetServiceBrowserCreate ( CFAllocatorRef alloc, CFNetServiceBrowserClientCallBack clientCB, CFNetServiceClientContext *clientContext );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`clientCB`	Функция обратного вызова, которую нужно вызвать, когда найдены домены и службы; не может быть `NULL`. Для получения дополнительной информации посмотрите `CFNetServiceBrowserClientCallBack`.
`clientContext`	Контекстная информация, которая будет использоваться, когда `clientCB` вызывается; не может быть `NULL`. Для получения дополнительной информации посмотрите `CFNetServiceClientContext`.

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

Новый объект браузера, или NULL если не мог бы быть создан экземпляр. Владение соблюдает Создать Правило.

Обсуждение

Эта функция создает экземпляр объекта браузера Сетевой службы, названного CFNetServiceBrowser, который может использоваться для поиска доменов и для служб.

Для использования получающегося CFNetServiceBrowser в асинхронном режиме вызвать CFNetServiceBrowserScheduleWithRunLoop. Тогда вызовите CFNetServiceBrowserSearchForDomains и CFNetServiceBrowserSearchForServices использовать CFNetServiceBrowser для поиска служб и доменов, соответственно. Функция обратного вызова, указанная clientCB вызывается от цикла выполнения для передачи результатов поиска приложению. Поиск продолжается, пока Вы не останавливаете поиск путем вызова CFNetServiceBrowserStopSearch.

Если Вы не вызываете CFNetServiceBrowserScheduleWithRunLoop, поиски с получающимся CFNetServiceBrowser сделаны в синхронном режиме. Вызовы, выполненные к CFNetServiceBrowserSearchForDomains и CFNetServiceBrowserSearchForServices блок до существует результаты поиска, когда функция обратного вызова, указанная clientCB вызывается, пока поиск не, останавливаются путем вызова CFNetServiceBrowserStopSearch от другого потока или ошибки происходит.

Для закрытия CFNetServiceBrowser, работающего в асинхронном режиме вызвать CFNetServiceBrowserStopSearch, сопровождаемый CFNetServiceBrowserUnscheduleFromRunLoop, и затем CFNetServiceBrowserInvalidate.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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

Функции CFNetServices


    
    CFNetServiceBrowserInvalidate (_:)
    CFNetServiceBrowserInvalidate

Лишает законной силы экземпляр объекта браузера Сетевой службы.

Объявление

Swift

func CFNetServiceBrowserInvalidate(_ browser: CFNetServiceBrowser!)

Objective C

void CFNetServiceBrowserInvalidate ( CFNetServiceBrowserRef browser );

Параметры


      browser

CFNetServiceBrowser для лишения законной силы, полученный предыдущим вызовом к CFNetServiceBrowserCreate.

Обсуждение

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, пока другой поток не изменяет тот же CFNetServiceBrowserRef одновременно.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceBrowserScheduleWithRunLoop (_: _: _:)
    CFNetServiceBrowserScheduleWithRunLoop

Планирует CFNetServiceBrowser на цикл выполнения.

Объявление

Swift

func CFNetServiceBrowserScheduleWithRunLoop(_ browser: CFNetServiceBrowser!, _ runLoop: CFRunLoop!, _ runLoopMode: CFString!)

Objective C

void CFNetServiceBrowserScheduleWithRunLoop ( CFNetServiceBrowserRef browser, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`browser`	CFNetServiceBrowser, который должен быть запланирован на цикл выполнения; не может быть `NULL`.
`runLoop`	Цикл выполнения, на который должен быть запланирован браузер; не может быть `NULL`.
`runLoopMode`	Режим, на который можно запланировать браузер; не может быть `NULL`.

Обсуждение

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceBrowserSearchForDomains (_: _: _:)
    CFNetServiceBrowserSearchForDomains

Поиски доменов.

Объявление

Swift

func CFNetServiceBrowserSearchForDomains(_ browser: CFNetServiceBrowser!, _ registrationDomains: Boolean, _ error: UnsafeMutablePointer<CFStreamError>) -> Boolean

Objective C

Boolean CFNetServiceBrowserSearchForDomains ( CFNetServiceBrowserRef browser, Boolean registrationDomains, CFStreamError *error );

Параметры

`browser`	CFNetServiceBrowser, полученный путем предыдущего вызова `CFNetServiceBrowserCreate`, это должно выполнить поиск; не может быть `NULL`.
`registrationDomains`	`TRUE` искать только регистрационные домены; `FALSE` искать домены, которые могут быть просмотрены для служб. Для этой версии CFNetServices API регистрационный домен является локальным доменом, сохраняемым mDNS респондентом, работающим на той же машине как вызывающее приложение.
`error`	Указатель на a `CFStreamError` структура, что, если ошибка происходит, будет установлена в ошибку и домен ошибки и передана Вашей функции обратного вызова. Передача `NULL` если Вы не хотите получать ошибку, которая может произойти в результате этого определенного вызова.

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

TRUE если поиск был запущен (асинхронный режим); FALSE если ошибка произошла, если другой поиск уже происходит для этого CFNetServiceBrowser или.

Обсуждение

Эта функция использует CFNetServiceBrowser для поиска доменов. Поиск продолжается, пока поиск не отменяется путем вызова CFNetServiceBrowserStopSearch. Если registrationDomains TRUE, эта функция ищет только домены, в которых могут быть зарегистрированы службы. Если registrationDomains FALSE, эта функция ищет домены, которые могут быть просмотрены для служб. То, когда домен найден, функция обратного вызова указала, когда CFNetServiceBrowser создавался, вызывают и передало экземпляр CFStringRef, содержащего найденный домен.

В асинхронном режиме, эта функция возвраты TRUE если был запущен поиск. Иначе, это возвращается FALSE.

В синхронном режиме это функциональные блоки, пока поиск не останавливается путем вызова CFNetServiceBrowserStopSearch от другого потока, когда это возвращается FALSE, или пока ошибка не происходит.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

Для любого CFNetServiceBrowser только один доменный поиск или один поиск службы могут произойти одновременно.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceBrowserSearchForServices (_: _: _: _:)
    CFNetServiceBrowserSearchForServices

Ищет домен службы указанного типа.

Объявление

Swift

func CFNetServiceBrowserSearchForServices(_ browser: CFNetServiceBrowser!, _ domain: CFString!, _ type: CFString!, _ error: UnsafeMutablePointer<CFStreamError>) -> Boolean

Objective C

Boolean CFNetServiceBrowserSearchForServices ( CFNetServiceBrowserRef browser, CFStringRef domain, CFStringRef serviceType, CFStreamError *error );

Параметры

`browser`	CFNetServiceBrowser, полученный путем предыдущего вызова `CFNetServiceBrowserCreate`, это должно выполнить поиск; не может быть `NULL`.
`domain`	Домен для поиска типа службы; не может быть `NULL`. Для получения доменов, которые доступны для поиска вызвать `CFNetServiceBrowserSearchForDomains`.
`type`	Тип службы для поиска; не может быть `NULL`. Для списка допустимых типов службы посмотрите http://www .iana.org/assignments/port-numbers.
`error`	Указатель на a `CFStreamError` структура, что, если ошибка происходит, будет установлена в ошибку и домен ошибки и передана Вашей функции обратного вызова. Передача `NULL` если Вы не хотите получать ошибку, которая может произойти в результате этого определенного вызова.

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

Обсуждение

Эта функция ищет указанный домен службы, соответствующие указанный тип службы. Поиск продолжается, пока поиск не отменяется путем вызова CFNetServiceBrowserStopSearch. То, когда соответствие найдено, функция обратного вызова указала, когда CFNetServiceBrowser создавался, вызывают и передало экземпляр CFNetService, представляющего найденную службу.

В асинхронном режиме, эта функция возвраты TRUE если был запущен поиск. Иначе, это возвращается FALSE.

В синхронном режиме это функциональные блоки, пока поиск не останавливается путем вызова CFNetServiceBrowserStopSearch от другого потока, когда возвращается эта функция FALSE, или пока ошибка не происходит.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

Для любого CFNetServiceBrowser только один доменный поиск или один поиск службы могут произойти одновременно.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceBrowserStopSearch (_: _:)
    CFNetServiceBrowserStopSearch

Останавливает поиск доменов или служб.

Объявление

Swift

func CFNetServiceBrowserStopSearch(_ browser: CFNetServiceBrowser!, _ error: UnsafeMutablePointer<CFStreamError>)

Objective C

void CFNetServiceBrowserStopSearch ( CFNetServiceBrowserRef browser, CFStreamError *error );

Параметры


      browser

CFNetServiceBrowser, использовавшийся для запуска поиска; не может быть NULL.


      error

Указатель на a CFStreamError структура, которая будет передана функции обратного вызова, связанной с этим CFNetServiceBrowser (если поиск проводится в асинхронном режиме) или на это указывают error параметр, когда CFNetServiceBrowserSearchForDomains или CFNetServiceBrowserSearchForServices возвраты (если поиск проводится в синхронном режиме). Установите domain поле к kCFStreamErrorDomainCustom и error поле к надлежащему значению.

Обсуждение

Это функционирует, останавливает поиск, запущенный предыдущим вызовом к CFNetServiceBrowserSearchForDomains или CFNetServiceBrowserSearchForServices. Для асинхронных и синхронных поисков, вызывая эту функцию заставляет функцию обратного вызова, связанную с CFNetServiceBrowser быть вызванной один раз для каждого домена или найденной службы. Если поиск является асинхронным, error передается функции обратного вызова. Если поиск синхронен, вызывая эту функцию причины CFNetServiceBrowserSearchForDomains или CFNetServiceBrowserSearchForServices возвратиться FALSE. Если error параметр для любого вызова указал на a CFStreamError структура, CFStreamError когда эта функция была вызвана, структура содержит код ошибки и домен кода ошибки, как установлено.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

При остановке асинхронного поиска, прежде, чем вызвать эту функцию, вызвать CFNetServiceBrowserUnscheduleFromRunLoop, сопровождаемый CFNetServiceBrowserInvalidate.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceBrowserUnscheduleFromRunLoop (_: _: _:)
    CFNetServiceBrowserUnscheduleFromRunLoop

Не планирует CFNetServiceBrowser от цикла выполнения и режима.

Объявление

Swift

func CFNetServiceBrowserUnscheduleFromRunLoop(_ browser: CFNetServiceBrowser!, _ runLoop: CFRunLoop!, _ runLoopMode: CFString!)

Objective C

void CFNetServiceBrowserUnscheduleFromRunLoop ( CFNetServiceBrowserRef browser, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`browser`	CFNetServiceBrowser, который должен быть не запланирован; не может быть `NULL`.
`runLoop`	Цикл выполнения; не может быть `NULL`.
`runLoopMode`	Режим, от которого браузер должен быть не запланирован; не может быть `NULL`.

Обсуждение

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceCancel (_:)
    CFNetServiceCancel

Отменяет регистрацию службы или разрешение службы.

Объявление

Swift

func CFNetServiceCancel(_ theService: CFNetService!)

Objective C

void CFNetServiceCancel ( CFNetServiceRef theService );

Параметры


      theService

CFNetService, полученный путем предыдущего вызова CFNetServiceCreate, для которого должны быть отменены регистрация или разрешение.

Обсуждение

Эта функция отменяет регистрацию службы, запущенную CFNetServiceRegister, таким образом, делая службу недоступной. Это также отменяет разрешения службы, запущенные CFNetServiceResolve.

Если Вы закрываете асинхронную службу, необходимо сначала вызвать CFNetServiceUnscheduleFromRunLoop и CFNetServiceSetClient с clientCB набор к NULL. Тогда вызовите эту функцию.

Если Вы закрываете синхронную службу, вызываете эту функцию от другого потока.

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceCreateDictionaryWithTXTData (_: _:)
    CFNetServiceCreateDictionaryWithTXTData

Использование TXT записывает данные для создания словаря.

Объявление

Swift

func CFNetServiceCreateDictionaryWithTXTData(_ alloc: CFAllocator!, _ txtRecord: CFData!) -> Unmanaged<CFDictionary>!

Objective C

CFDictionaryRef CFNetServiceCreateDictionaryWithTXTData ( CFAllocatorRef alloc, CFDataRef txtRecord );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`txtRecord`	TXT записывают данные, как возвращено `CFNetServiceGetTXTData`.

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

Словарь, содержащий пары ключ/значение, проанализированные от txtRecord, или NULL если txtRecord не может быть проанализирован. Каждый ключ в словаре является объектом CFString, и каждое значение является объектом CFData. Владение соблюдает Создать Правило.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceCreateTXTDataWithDictionary (_: _:)
    CFNetServiceCreateTXTDataWithDictionary

Сглаживает ряд пар ключ/значение в CFDataRef, подходящий для передачи CFNetServiceSetTXTData.

Объявление

Swift

func CFNetServiceCreateTXTDataWithDictionary(_ alloc: CFAllocator!, _ keyValuePairs: CFDictionary!) -> Unmanaged<CFData>!

Objective C

CFDataRef CFNetServiceCreateTXTDataWithDictionary ( CFAllocatorRef alloc, CFDictionaryRef keyValuePairs );

Параметры


      alloc

Средство выделения для использования для выделения памяти для нового объекта. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.


      keyValuePairs

CFDictionaryRef, содержащий пары ключ/значение, которые должны быть помещены в запись TXT. Каждым ключом должен быть CFStringRef, и каждым значением должен быть CFDataRef или CFStringRef. (См. обсуждение ниже для получения дополнительной информации о значениях, которые являются CFStringRefs.) Если какие-либо другие типы данных предоставлены, эта функция перестала работать. Длина ключа и его значения не должна превышать 255 байтов.

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

Объект CFData, содержащий сглаженную форму keyValuePairs, или NULL если не мог бы быть сглажен словарь. Владение соблюдает Создать Правило.

Обсуждение

Эта функция сглаживает пары ключ/значение в словаре, указанном keyValuePairs в CFDataRef, подходящий для передачи CFNetServiceSetTXTData. Обратите внимание на то, что эта функция не является функцией общего назначения для выравнивания CFDictionaryRefs.

Ключи в словаре, на который ссылаются keyValuePairs должен быть CFStringRefs, и значениями должен быть CFDataRefs. Любые значения, которые являются CFStringRefs, преобразовываются в CFDataRefs, представляющий сглаженные байты UTF-8 строки. Типы значений не кодируются в CFDataRefs, таким образом, любые CFStringRefs, преобразовывающиеся в CFDataRefs, остаются CFDataRefs, когда CFDataRef, произведенный этой функцией, обрабатывается CFNetServiceCreateDictionaryWithTXTData.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceGetAddressing (_:)
    CFNetServiceGetAddressing

Получает IP-адресацию от CFNetService.

Объявление

Swift

func CFNetServiceGetAddressing(_ theService: CFNetService!) -> Unmanaged<CFArray>!

Objective C

CFArrayRef CFNetServiceGetAddressing ( CFNetServiceRef theService );

Параметры


      theService

CFNetService, IP-адресация которого должна быть получена; не может быть NULL.

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

CFArray, содержащий CFDataRef для каждого IP-адреса, возвратился, или NULL. Каждый CFDataRef состоит из a sockaddr структура, содержащая IP-адрес службы. Эта функция возвраты NULL если обращение службы неизвестно потому что CFNetServiceResolve не требовался theService.

Обсуждение

Эта функция получает IP-адресацию от CFNetService. Как правило, CFNetService был получен путем вызова CFNetServiceBrowserSearchForServices. Прежде, чем вызвать эту функцию, вызвать CFNetServiceResolve обновить CFNetService с его IP-адресацией.

Специальные замечания

Эта функция получает данные ориентированным на многопотоковое исполнение способом, но сами данные не безопасны, если служба изменена от другого потока.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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

CFNetServiceGetTargetHost (_:) CFNetServiceGetTargetHost

Запрашивает CFNetService для его целевых узлов.

Объявление

Swift

func CFNetServiceGetTargetHost(_ theService: CFNetService!) -> Unmanaged<CFString>!

Objective C

CFStringRef CFNetServiceGetTargetHost ( CFNetServiceRef theService );

Параметры

theService

Сетевая служба, которая будет запрошена.

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

Имя целевого узла машины, предоставляющей услугу или NULL имеет целевой узел службы, не известен. (Целевой узел не будет известен, если он не был разрешен.)

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, но имя целевого узла не безопасно, если служба изменена от другого потока.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
CFNetServiceGetDomain (_:) CFNetServiceGetDomain

Получает домен от CFNetService.

Объявление

Swift

func CFNetServiceGetDomain(_ theService: CFNetService!) -> Unmanaged<CFString>!

Objective C

CFStringRef CFNetServiceGetDomain ( CFNetServiceRef theService );

Параметры

theService

CFNetService, домен которого должен быть получен; не может быть NULL.

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

Объект CFString, содержащий домен CFNetService.

Обсуждение

Эта функция получает домен от CFNetService.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение. Функция получает данные ориентированным на многопотоковое исполнение способом, но данные не безопасны, если служба изменена от другого потока.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
CFNetServiceGetName (_:) CFNetServiceGetName

Завоевывает репутацию от CFNetService.

Объявление

Swift

func CFNetServiceGetName(_ theService: CFNetService!) -> Unmanaged<CFString>!

Objective C

CFStringRef CFNetServiceGetName ( CFNetServiceRef theService );

Параметры

theService

CFNetService, имя которого должно быть получено; не может быть NULL.

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

Объект CFString, содержащий имя службы, представлен CFNetService.

Обсуждение

Эта функция завоевывает репутацию от CFNetService.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение. Функция получает данные ориентированным на многопотоковое исполнение способом, но данные не безопасны, если служба изменена от другого потока.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceGetPortNumber (_:)
    CFNetServiceGetPortNumber

Эта функция получает номер порта от CFNetService.

Объявление

Swift

func CFNetServiceGetPortNumber(_ theService: CFNetService!) -> Int32

Objective C

SInt32 CFNetServiceGetPortNumber ( CFNetServiceRef theService );

Параметры


      theService

CFNetService, специфичная для протокола информация которого должна быть получена; не может быть NULL. Обратите внимание на то, что для получения специфичной для протокола информации, необходимо решить theService путем вызова CFNetServiceResolve или CFNetServiceResolveWithTimeout прежде, чем вызвать эту функцию.

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

Номер порта службы.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceGetTXTData (_:)
    CFNetServiceGetTXTData

Запрашивает сетевую службу для содержания ее записей TXT.

Объявление

Swift

func CFNetServiceGetTXTData(_ theService: CFNetService!) -> Unmanaged<CFData>!

Objective C

CFDataRef CFNetServiceGetTXTData ( CFNetServiceRef theService );

Параметры


      theService

Ссылка для сетевой службы, данные записи TXT которой должны быть получены; не может быть NULL. Обратите внимание на то, что для получения, TXT записывают данные, необходимо решить theService путем вызова CFNetServiceResolve или CFNetServiceResolveWithTimeout прежде, чем вызвать эту функцию.

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

Объект CFDataRef, содержащий запрошенные данные TXT и подходящий для передачи CFNetServiceCreateDictionaryWithTXTData, или NULL если не были разрешены данные службы TXT.

Обсуждение

Эта функция получает данные от записей TXT службы.

Специальные замечания

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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

CFNetServiceGetType (_:) CFNetServiceGetType

Получает тип от CFNetService.

Объявление

Swift

func CFNetServiceGetType(_ theService: CFNetService!) -> Unmanaged<CFString>!

Objective C

CFStringRef CFNetServiceGetType ( CFNetServiceRef theService );

Параметры

theService

CFNetService, тип которого должен быть получен; не может быть NULL.

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

Объект CFString, содержащий тип от CFNetService.

Обсуждение

Эта функция получает тип CFNetService.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение. Функция получает данные ориентированным на многопотоковое исполнение способом, но данные не безопасны, если служба изменена от другого потока.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
CFNetServiceMonitorInvalidate (_:) CFNetServiceMonitorInvalidate

Лишает законной силы экземпляр объекта монитора Сетевой службы.

Объявление

Swift

func CFNetServiceMonitorInvalidate(_ monitor: CFNetServiceMonitor!)

Objective C

void CFNetServiceMonitorInvalidate ( CFNetServiceMonitorRef monitor );

Параметры

monitor

CFNetServiceMonitor для лишения законной силы; не может быть NULL.

Обсуждение

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceMonitorScheduleWithRunLoop (_: _: _:)
    CFNetServiceMonitorScheduleWithRunLoop

Планирует CFNetServiceMonitor на цикл выполнения.

Объявление

Swift

func CFNetServiceMonitorScheduleWithRunLoop(_ theService: CFNetServiceMonitor!, _ runLoop: CFRunLoop!, _ runLoopMode: CFString!)

Objective C

void CFNetServiceMonitorScheduleWithRunLoop ( CFNetServiceMonitorRef monitor, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`theService`	CFNetServiceMonitor, который должен быть запланирован на цикл выполнения; не может быть `NULL`.
`runLoop`	Цикл выполнения, на который должен быть запланирован монитор; не может быть `NULL`.
`runLoopMode`	Режим, на который можно запланировать монитор; не может быть `NULL`.

Обсуждение

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceMonitorStart (_: _: _:)
    CFNetServiceMonitorStart

Начинает контролировать.

Объявление

Swift

func CFNetServiceMonitorStart(_ monitor: CFNetServiceMonitor!, _ recordType: CFNetServiceMonitorType, _ error: UnsafeMutablePointer<CFStreamError>) -> Boolean

Objective C

Boolean CFNetServiceMonitorStart ( CFNetServiceMonitorRef monitor, CFNetServiceMonitorType recordType, CFStreamError *error );

Параметры

`monitor`	CFNetServiceMonitor, создаваемый путем вызова `CFNetServiceMonitorCreate`, это должно быть запущено.
`recordType`	CFNetServiceMonitorType, указавший тип записи на монитор. Для возможных значений посмотрите Константы CFNetServiceMonitorType.
`error`	Указатель на a `CFStreamError` структура. Если ошибка происходит, на выводе, структура `domain` поле будет установлено в домен кода ошибки и `error` поле будет установлено в надлежащий код ошибки. Установите этот параметр на `NULL` если Вы не хотите получать код ошибки и его домен.

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

TRUE если асинхронный монитор был запущен успешно. FALSE если ошибка произошла при запуске асинхронного или синхронного монитора, или если CFNetServiceMonitorStop был вызван для синхронного монитора.

Обсуждение

Эта функция начинает контролировать для изменений в записях типа, указанного recordType. Если монитор уже работает за службой, связанной с указанным CFNetServiceMonitorRef, эта функция возвраты FALSE.

Для синхронных мониторов, это функциональные блоки, пока монитор не останавливается путем вызова CFNetServiceMonitorStop, когда, эта функция возвраты FALSE.

Для асинхронных мониторов, эта функция возвраты TRUE или FALSEВ зависимости от того, запускается ли контроль успешно.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceMonitorStop (_: _:)
    CFNetServiceMonitorStop

Останавливает CFNetServiceMonitor.

Объявление

Swift

func CFNetServiceMonitorStop(_ monitor: CFNetServiceMonitor!, _ error: UnsafeMutablePointer<CFStreamError>)

Objective C

void CFNetServiceMonitorStop ( CFNetServiceMonitorRef monitor, CFStreamError *error );

Параметры


      monitor

CFNetServiceMonitor, запущенный путем вызова CFNetServiceMonitorStart, это должно быть остановлено.


      error

Указатель на a CFStreamError структура или NULL. Для синхронных мониторов, набор error поле этой структуры к ненулевому значению Вы хотите быть установленными в CFStreamError структура, когда CFNetServiceMonitorStart возвраты. Обратите внимание на то, что, когда это возвращается, CFNetServiceMonitorStart возвраты FALSE. Если монитор был запущен асинхронно, установите error поле к ненулевому значению, которое Вы хотите, чтобы обратный вызов монитора получил, когда это вызывают. Если этот параметр NULL, значения по умолчанию для CFStreamError структура используется: домен установлен в kCFStreamErrorDomainNetServices и код ошибки установлен в kCFNetServicesErrorCancel.

Обсуждение

Эта функция останавливает указанный монитор. Вызвать CFNetServiceMonitorStart если Вы хотите начать контролировать снова.

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceMonitorUnscheduleFromRunLoop (_: _: _:)
    CFNetServiceMonitorUnscheduleFromRunLoop

Не планирует CFNetServiceMonitor от цикла выполнения.

Объявление

Swift

func CFNetServiceMonitorUnscheduleFromRunLoop(_ monitor: CFNetServiceMonitor!, _ runLoop: CFRunLoop!, _ runLoopMode: CFString!)

Objective C

void CFNetServiceMonitorUnscheduleFromRunLoop ( CFNetServiceMonitorRef monitor, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`monitor`	CFNetServiceMonitor, который должен быть не запланирован; не может быть `NULL`.
`runLoop`	Цикл выполнения; не может быть `NULL`.
`runLoopMode`	Режим, от которого монитор должен быть не запланирован; не может быть `NULL`.

Обсуждение

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

Для изменения монитора так, чтобы это не могло быть запланировано и так, чтобы его обратный вызов никогда не вызывали вызвать CFNetServiceMonitorInvalidate.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceRegisterWithOptions (_: _: _:)
    CFNetServiceRegisterWithOptions

Делает CFNetService доступным в сети.

Объявление

Swift

func CFNetServiceRegisterWithOptions(_ theService: CFNetService!, _ options: CFOptionFlags, _ error: UnsafeMutablePointer<CFStreamError>) -> Boolean

Objective C

Boolean CFNetServiceRegisterWithOptions ( CFNetServiceRef theService, CFOptionFlags options, CFStreamError *error );

Параметры

`theService`	Сетевая служба для регистрации; не может быть `NULL`. Если служба не будет иметь домена, типа, имени и IP-адреса, регистрация перестанет работать.
`options`	Битовые флаги для указания регистрационных опций. В настоящее время единственная регистрационная опция `kCFNetServiceFlagNoAutoRename`. Для получения дополнительной информации посмотрите Регистрационные Опции CFNetService.
`error`	Указатель на a `CFStreamError` структура, которая будет установлена в код ошибки и домен кода ошибки, если произойдет ошибка; или `NULL` если Вы не хотите получать код ошибки и его домен.

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

TRUE если была запущена асинхронная регистрация службы; FALSE если синхронная регистрация была отменена, если асинхронная или синхронная регистрация перестала работать или.

Обсуждение

Если служба должна работать в асинхронном режиме, необходимо вызвать CFNetServiceSetClient связать функцию обратного вызова с этим CFNetService прежде, чем вызвать эту функцию.

При регистрации службы, работающей в асинхронном режиме, эта функция возвраты TRUE если служба содержит все требуемые атрибуты, и процесс регистрации может запуститься. Если процесс регистрации завершается успешно, служба доступна в сети, пока Вы не закрываете службу путем вызова CFNetServiceUnscheduleFromRunLoop, CFNetServiceSetClient, и CFNetServiceCancel. Если процесс регистрации не завершается успешно, эта функция возвраты, если служба не содержит все требуемые атрибуты или FALSE.

При регистрации службы, работающей в синхронном режиме, это функциональные блоки, пока не происходит ошибка, когда возвращается эта функция FALSE. До этой функции возвраты FALSE, служба доступна в сети. Вынудить эту функцию возвратиться FALSE, таким образом, закрывая службу, вызвать CFNetServiceCancel от другого потока.

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceResolveWithTimeout (_: _: _:)
    CFNetServiceResolveWithTimeout

Получает IP-адрес или адреса для CFNetService.

Объявление

Swift

func CFNetServiceResolveWithTimeout(_ theService: CFNetService!, _ timeout: CFTimeInterval, _ error: UnsafeMutablePointer<CFStreamError>) -> Boolean

Objective C

Boolean CFNetServiceResolveWithTimeout ( CFNetServiceRef theService, CFTimeInterval timeout, CFStreamError *error );

Параметры

`theService`	CFNetService для разрешения; не может быть `NULL`. Если служба не будет иметь домена, типа и имени, разрешение перестанет работать.
`timeout`	Значение типа `CFTimeInterval` указание максимальной суммы времени позволило выполнять разрешение. Если разрешение не будет выполняться в указанном количестве времени, то ошибка из-за тайм-аута будет возвращена. Если `timeout` меньше чем или равно нулю, бесконечное количество времени позволяется.
`error`	Указатель на a `CFStreamError` структура, которая будет установлена в код ошибки и домен кода ошибки, если произойдет ошибка; или `NULL` если Вы не хотите получать код ошибки и его домен.

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

TRUE если синхронное разрешение службы обновило CFNetService, если асинхронное разрешение службы было запущено или; FALSE если синхронное разрешение было отменено, если асинхронное или синхронное разрешение перестало работать или испытало таймаут, или.

Обсуждение

Эта функция обновляет указанный CFNetService с IP-адресом или адресами, связанными со службой. Вызвать CFNetServiceGetAddressing получить адреса.

При разрешении службы, работающей в асинхронном режиме, эта функция возвраты TRUE если CFNetService имеет домен, введите, и имя, и базовый процесс разрешения был запущен. Иначе, эта функция возвраты FALSE. После того, как запущенный, разрешение продолжается, пока оно не отменяется путем вызова CFNetServiceCancel.

При разрешении службы, работающей в синхронном режиме, это функциональные блоки, пока CFNetService не обновляется по крайней мере с одним IP-адресом, пока ошибка не происходит, или до CFNetServiceCancel вызывается.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceScheduleWithRunLoop (_: _: _:)
    CFNetServiceScheduleWithRunLoop

Планирует CFNetService на цикл выполнения.

Объявление

Swift

func CFNetServiceScheduleWithRunLoop(_ theService: CFNetService!, _ runLoop: CFRunLoop!, _ runLoopMode: CFString!)

Objective C

void CFNetServiceScheduleWithRunLoop ( CFNetServiceRef theService, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`theService`	CFNetService, который должен быть запланирован на цикл выполнения; не может быть `NULL`.
`runLoop`	Цикл выполнения, на который должна быть запланирована служба; не может быть `NULL`.
`runLoopMode`	Режим, на который можно запланировать службу; не может быть `NULL`.

Обсуждение

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

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

Прежде, чем вызвать эту функцию, вызвать CFNetServiceSetClient подготавливать CFNetService к использованию в асинхронном режиме.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceSetClient (_: _: _:)
    CFNetServiceSetClient

Связывает функцию обратного вызова с CFNetService или разъединяет функцию обратного вызова с CFNetService.

Объявление

Swift

func CFNetServiceSetClient(_ theService: CFNetService!, _ clientCB: CFNetServiceClientCallBack, _ clientContext: UnsafeMutablePointer<CFNetServiceClientContext>) -> Boolean

Objective C

Boolean CFNetServiceSetClient ( CFNetServiceRef theService, CFNetServiceClientCallBack clientCB, CFNetServiceClientContext *clientContext );

Параметры

`theService`	CFNetService; не может быть `NULL`.
`clientCB`	Функция обратного вызова, которая должна быть связана с этим CFNetService. Если Вы закрываете службу, набор `clientCB` к `NULL` разъединять с этим CFNetService ранее связанную функцию обратного вызова.
`clientContext`	Контекстная информация, которая будет использоваться, когда `clientCB` вызывается; не может быть `NULL`.

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

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

Обсуждение

Функция обратного вызова, указанная clientCB будет вызван для создания отчетов о IP-адресах (в случае CFNetServiceResolve) или сообщить об ошибках при регистрации (в случае CFNetServiceRegister).

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

Для CFNetService, который будет работать асинхронно, вызовите эту функцию и затем вызовите CFNetServiceScheduleWithRunLoop запланировать службу на цикл выполнения. Тогда вызовите CFNetServiceRegister или CFNetServiceResolve.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceSetTXTData (_: _:)
    CFNetServiceSetTXTData

Устанавливает рекорд TXT для CFNetService.

Объявление

Swift

func CFNetServiceSetTXTData(_ theService: CFNetService!, _ txtRecord: CFData!) -> Boolean

Objective C

Boolean CFNetServiceSetTXTData ( CFNetServiceRef theService, CFDataRef txtRecord );

Параметры

`theService`	CFNetServiceRef, для которого должен быть установлен рекорд TXT; не может быть `NULL`.
`txtRecord`	Содержание рекорда TXT, который должен быть установлен. Содержание не должно превышать 1 450 байтов.

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

TRUE если был установлен рекорд TXT; иначе, FALSE.

Обсуждение

Эта функция устанавливает рекорд TXT для указанной службы. Если служба в настоящее время регистрируется в сети, запись широковещательно передается. Устанавливание рекорда TXT на все еще разрешающейся службе не позволяется.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceUnscheduleFromRunLoop (_: _: _:)
    CFNetServiceUnscheduleFromRunLoop

Не планирует CFNetService от цикла выполнения.

Объявление

Swift

func CFNetServiceUnscheduleFromRunLoop(_ theService: CFNetService!, _ runLoop: CFRunLoop!, _ runLoopMode: CFString!)

Objective C

void CFNetServiceUnscheduleFromRunLoop ( CFNetServiceRef theService, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`theService`	CFNetService, который должен быть не запланирован; не может быть `NULL`.
`runLoop`	Цикл выполнения; не может быть `NULL`.
`runLoopMode`	Режим, от которого служба должна быть не запланирована; не может быть `NULL`.

Обсуждение

Не планирует указанную службу от указанного цикла выполнения и режима. Вызовите эту функцию для закрытия службы, работающей асинхронно. Для завершения завершения работы вызвать CFNetServiceSetClient и набор clientCB к NULL. Тогда вызовите CFNetServiceCancel.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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

Получение идентификаторов типов сетевой службы

CFNetServiceGetTypeID () CFNetServiceGetTypeID

Получает Базовый идентификатор типа Основы для объекта Сетевой службы.

Объявление

Swift

func CFNetServiceGetTypeID() -> CFTypeID

Objective C

CFTypeID CFNetServiceGetTypeID ( void );

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

Идентификатор типа.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
CFNetServiceMonitorGetTypeID () CFNetServiceMonitorGetTypeID

Получает Базовый идентификатор типа Основы для всех экземпляров CFNetServiceMonitor.

Объявление

Swift

func CFNetServiceMonitorGetTypeID() -> CFTypeID

Objective C

CFTypeID CFNetServiceMonitorGetTypeID ( void );

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

Идентификатор типа.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
CFNetServiceBrowserGetTypeID () CFNetServiceBrowserGetTypeID

Получает Базовый идентификатор типа Основы для объекта браузера Сетевой службы.

Объявление

Swift

func CFNetServiceBrowserGetTypeID() -> CFTypeID

Objective C

CFTypeID CFNetServiceBrowserGetTypeID ( void );

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

Идентификатор типа.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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

Обратные вызовы

Группа


    
    CFNetServiceBrowserClientCallBack

Определяет указатель на функцию обратного вызова для CFNetServiceBrowser.

Объявление

Swift

typealias CFNetServiceBrowserClientCallBack = CFunctionPointer<((CFNetServiceBrowser!, CFOptionFlags, AnyObject!, UnsafeMutablePointer<CFStreamError>, UnsafeMutablePointer<Void>) -> Void)>

Objective C

typedef void (*CFNetServiceBrowserClientCallBack) ( CFNetServiceBrowserRef browser, CFOptionFlags flags, CFTypeRef domainOrService, CFStreamError * error, void* info);

Параметры

`browser`	CFNetServiceBrowser связался с этой функцией обратного вызова.
`flags`	Флаги, передающие дополнительную информацию. `kCFNetServiceFlagIsDomain` бит установлен если `domainOrService` содержит домен; если этот бит не установлен, `domainOrService` содержит экземпляр CFNetService. Для значений дополнительного бита посмотрите Битовые флаги CFNetServiceBrowserClientCallBack.
`domainOrService`	Строка, содержащая доменное имя, если эту функцию обратного вызова вызывают в результате вызова `CFNetServiceBrowserSearchForDomains`, или экземпляр CFNetService, если эту функцию обратного вызова вызывают, в результате вызывая `CFNetServiceBrowserSearchForServices`.
`error`	Указатель на a `CFStreamError` структура, чей `error` поле может содержать код ошибки.
`info`	Определяемая пользователем контекстная информация. Значение `info` совпадает со значением `info` поле `CFNetServiceClientContext` структура, которая была предоставлена когда `CFNetServiceBrowserCreate` был вызван для создания CFNetServiceBrowser, связанного с этой функцией обратного вызова.

Обсуждение

Когда домены или службы найдены как результат вызова, функцию обратного вызова для CFNetServiceBrowser вызывают один или несколько раз CFNetServiceBrowserSearchForDomains и CFNetServiceBrowserSearchForServices.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceClientCallBack

Определяет указатель на функцию обратного вызова для CFNetService.

Объявление

Swift

typealias CFNetServiceClientCallBack = CFunctionPointer<((CFNetService!, UnsafeMutablePointer<CFStreamError>, UnsafeMutablePointer<Void>) -> Void)>

Objective C

typedef void (*CFNetServiceClientCallBack) ( CFNetServiceRef theService, CFStreamError * error, void* info);

Параметры

`theService`	CFNetService связался с этой функцией обратного вызова.
`error`	Указатель на a `CFStreamError` структура, чей `error` поле содержит, может содержать код ошибки.
`info`	Определяемая пользователем контекстная информация. Значение `info` совпадает со значением `info` поле `CFNetServiceClientContext` структура, которая была предоставлена когда `CFNetServiceSetClient` был вызван для CFNetService, связанного с этой функцией обратного вызова.

Обсуждение

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

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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


    
    CFNetServiceMonitorClientCallBack

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

Объявление

Swift

typealias CFNetServiceMonitorClientCallBack = CFunctionPointer<((CFNetServiceMonitor!, CFNetService!, CFNetServiceMonitorType, CFData!, UnsafeMutablePointer<CFStreamError>, UnsafeMutablePointer<Void>) -> Void)>

Objective C

typedef void (*CFNetServiceMonitorClientCallBack) ( CFNetServiceMonitorRef theMonitor, CFNetServiceRef theService, CFNetServiceMonitorType typeInfo, CFDataRef rdata, CFStreamError * error, void* info);

Параметры

`theMonitor`	CFNetServiceMonitor, для которого вызывают обратный вызов.
`theService`	CFNetService, для которого вызывают обратный вызов.
`typeInfo`	Тип изменившейся записи. Для возможных значений посмотрите Константы CFNetServiceMonitorType.
`rdata`	Содержание изменившейся записи.
`error`	Указатель на `CFStreamError` структура, чей `error` если ошибка произошла, поле содержит код ошибки.
`info`	Произвольный указатель на определяемые пользователем данные, указанные в `info` поле `CFNetServiceClientContext` структура, когда монитор создавался `CFNetServiceMonitorCreate`.

Обсуждение

Функцию обратного вызова вызовут, когда наблюдаемые изменения типа записи или когда монитор будет остановлен путем вызова CFNetServiceMonitorStop.

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

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

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

Типы данных

CFNetServiceBrowserRef

Непрозрачная ссылка, представляющая CFNetServiceBrowser.

Объявление

Swift

typealias CFNetServiceBrowserRef = CFNetServiceBrowser

Objective C

typedef struct __CFNetServiceBrowser* CFNetServiceBrowserRef;

Доступность

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


      
      CFNetServiceClientContext

Структура обеспечила, когда CFNetService связан с функцией обратного вызова или когда создается CFNetServiceBrowser.

Объявление

Swift

struct CFNetServiceClientContext { var version: CFIndex var info: UnsafeMutablePointer<Void> var retain: CFAllocatorRetainCallBack var release: CFAllocatorReleaseCallBack var copyDescription: CFAllocatorCopyDescriptionCallBack init() init(version version: CFIndex, info info: UnsafeMutablePointer<Void>, retain retain: CFAllocatorRetainCallBack, release release: CFAllocatorReleaseCallBack, copyDescription copyDescription: CFAllocatorCopyDescriptionCallBack) }

Objective C

struct CFNetServiceClientContext { CFIndex version; void *info; CFAllocatorRetainCallBack retain; CFAllocatorReleaseCallBack release; CFAllocatorCopyDescriptionCallBack copyDescription; }; typedef struct CFNetServiceClientContext CFNetServiceClientContext;

Поля

`version`	Номер версии для этой структуры. В настоящее время единственное допустимое значение является нулем.
`info`	Произвольный указатель на выделенную пользователями память, содержащую определяемые пользователем данные, связанные со службой, браузером или монитором и передающиеся их соответствующим функциям обратного вызова. Данные должны быть допустимыми столько, сколько CFNetService, CFNetServiceBrowser или CFNetServiceMonitor допустимы. Установите это поле в `NULL` если Ваша функция обратного вызова не хочет получать определяемые пользователем данные.
`retain`	Обратный вызов раньше добавлял сохранение для использование браузера или службы `info` для жизни службы или браузера. Этот обратный вызов может использоваться для временных ссылок, которые должны взять служба или браузер. Этот обратный вызов возвращает фактическое `info` указатель, таким образом, это может быть сохранено в службе или браузере. Это поле может быть `NULL`.
`release`	Обратный вызов, удаляющий сохранение ранее добавленного для службы или браузера на `info` указатель. Это поле может быть `NULL`, но устанавливая это поле в `NULL` может привести к утечкам памяти.
`copyDescription`	Обратный вызов раньше создавал представление описательной строки данных, которыми указывают `info`. В реализации этой функции возвратите ссылку на объект CFString, описывающий Ваше средство выделения и некоторые характеристики Ваших определяемых пользователем данных, использующихся `CFCopyDescription()`. Можно установить это поле в `NULL`, когда Базовая Основа предоставит элементарное описание.

Доступность

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

CFNetServiceMonitorRef

Непрозрачная ссылка для монитора служб.

Объявление

Swift

typealias CFNetServiceMonitorRef = CFNetServiceMonitor

Objective C

typedef struct __CFNetServiceMonitor* CFNetServiceMonitorRef;

Обсуждение

Ссылки монитора служб используются для наблюдения рекордных изменений на CFNetServiceRef.

Доступность

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

Непрозрачная ссылка, представляющая CFNetService.

Объявление

Swift

typealias CFNetServiceRef = CFNetService

Objective C

typedef struct __CFNetService* CFNetServiceRef;

Доступность

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

Константы

Регистрационные опции CFNetService
Битовые флаги, используемые при регистрации службы.

Объявление

Swift

struct CFNetServiceRegisterFlags : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var FlagNoAutoRename: CFNetServiceRegisterFlags { get } }

Objective C

enum { kCFNetServiceFlagNoAutoRename = 1 };

Константы
- FlagNoAutoRename
  
  kCFNetServiceFlagNoAutoRename
  
  Регистрация причин, чтобы перестать работать, если происходит конфликт имен.
  
  Доступный в iOS 2.0 и позже.
Битовые флаги CFNetServiceBrowserClientCallBack
Битовые флаги, предоставляющие дополнительную информацию о результате, возвратились когда клиент CFNetServiceBrowserClientCallBack функция вызвана.

Объявление

Swift

struct CFNetServiceBrowserFlags : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var MoreComing: CFNetServiceBrowserFlags { get } static var IsDomain: CFNetServiceBrowserFlags { get } static var IsDefault: CFNetServiceBrowserFlags { get } static var IsRegistrationDomain: CFNetServiceBrowserFlags { get } static var Remove: CFNetServiceBrowserFlags { get } }

Objective C

enum { kCFNetServiceFlagMoreComing = 1, kCFNetServiceFlagIsDomain = 2, kCFNetServiceFlagIsDefault = 4, kCFNetServiceFlagIsRegistrationDomain = 4, /* For compatibility */ kCFNetServiceFlagRemove = 8 };

Константы
- MoreComing
  
  kCFNetServiceFlagMoreComing
  
  Если установлено, подсказка, что функцию обратного вызова клиента вызовут снова скоро; поэтому, клиент не должен делать ничего длительного, такого как обновление экрана.
  
  Доступный в iOS 2.0 и позже.
- IsDomain
  
  kCFNetServiceFlagIsDomain
  
  Если установлено, результаты принадлежат поиску доменов. Если не набор, результаты принадлежат поиску служб.
  
  Доступный в iOS 2.0 и позже.
- IsDefault
  
  kCFNetServiceFlagIsDefault
  
  Если установлено, получающийся домен является регистрацией по умолчанию или доменом обзора, в зависимости от контекста. Для этой версии CFNetServices API регистрационный домен по умолчанию является локальным доменом. В предыдущих версиях этого API эта константа была kCFNetServiceFlagIsRegistrationDomain, который сохраняется для обратной совместимости.
  
  Доступный в iOS 2.0 и позже.
- Remove
  
  kCFNetServiceFlagRemove
  
  Если установлено, клиент должен удалить элемент результата вместо того, чтобы добавить его.
  
  Доступный в iOS 2.0 и позже.
Обсуждение

Посмотрите CFNetServiceBrowserClientCallBack для получения дополнительной информации.
Константы CFNetServiceMonitorType
Спецификатор типа записи раньше говорил монитору служб тип рекордных изменений для наблюдения за.

Объявление

Swift

enum CFNetServiceMonitorType : Int32 { case TXT }

Objective C

enum { kCFNetServiceMonitorTXT = 1 } typedef enum CFNetServiceMonitorType CFNetServiceMonitorType;

Константы
- TXT
  
  kCFNetServiceMonitorTXT
  
  Наблюдайте за изменениями записи TXT.
  
  Доступный в iOS 2.0 и позже.
Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
Ошибочные константы CFNetService
Коды ошибки, которые могут быть возвращены функциями CFNetServices или переданы функциям обратного вызова CFNetServices.

Объявление

Swift

enum CFNetServicesError : Int32 { case Unknown case Collision case NotFound case InProgress case BadArgument case Cancel case Invalid case Timeout }

Objective C

typedef enum { kCFNetServicesErrorUnknown = -72000, kCFNetServicesErrorCollision = -72001, kCFNetServicesErrorNotFound = -72002, kCFNetServicesErrorInProgress = -72003, kCFNetServicesErrorBadArgument = -72004, kCFNetServicesErrorCancel = -72005, kCFNetServicesErrorInvalid = -72006, kCFNetServicesErrorTimeout = -72007 } CFNetServicesError;

Константы
- Unknown
  
  kCFNetServicesErrorUnknown
  
  Произошла неизвестная ошибка CFNetService.
  
  Доступный в iOS 2.0 и позже.
- Collision
  
  kCFNetServicesErrorCollision
  
  Попытка была предпринята для использования уже использующегося имени.
  
  Доступный в iOS 2.0 и позже.
- NotFound
  
  kCFNetServicesErrorNotFound
  
  Не используемый.
  
  Доступный в iOS 2.0 и позже.
- InProgress
  
  kCFNetServicesErrorInProgress
  
  Поиск уже происходит.
  
  Доступный в iOS 2.0 и позже.
- BadArgument
  
  kCFNetServicesErrorBadArgument
  
  Обязательный аргумент не был предоставлен.
  
  Доступный в iOS 2.0 и позже.
- Cancel
  
  kCFNetServicesErrorCancel
  
  Поиск или служба были отменены.
  
  Доступный в iOS 2.0 и позже.
- Invalid
  
  kCFNetServicesErrorInvalid
  
  Недопустимые данные были переданы функции CFNetServices.
  
  Доступный в iOS 2.0 и позже.
- Timeout
  
  kCFNetServicesErrorTimeout
  
  Разрешение перестало работать, потому что был достигнут тайм-аут.
  
  Доступный в iOS 2.0 и позже.
Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в iOS 2.0 и позже.
Ошибочные домены
Ошибочные домены.

Объявление

Swift

let kCFStreamErrorDomainMach: Int32 let kCFStreamErrorDomainNetServices: Int32

Objective C

extern const SInt32 kCFStreamErrorDomainMach; extern const SInt32 kCFStreamErrorDomainNetServices;

Константы
- kCFStreamErrorDomainMach
  
  Ошибки возврата домена Error, о которых сообщает Мах. Для получения дополнительной информации посмотрите заголовочный файл /usr/include/mach/error.h.
  
  Доступный в iOS 2.0 и позже.
- kCFStreamErrorDomainNetServices
  
  Ошибки возврата домена Error, о которых сообщает открытие службы APIs. Если Вы используете, эти ошибки только возвращаются CFNetServiceBrowser API или любой APIs, представленный в OS X v10.4 или позже.
  
  Доступный в iOS 2.0 и позже.