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

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

Разработчик

Ссылка платформы основы ссылка класса NSSocketPortNameServer

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

На этой странице
Язык:

NSSocketPortNameServer

Этот сервер имен порта берет и возвращает экземпляры NSSocketPort.

Функциональность удаления порта поддерживается removePortForName: метод и должен использоваться для удаления недопустимых портов сокета.

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

NSPortNameServer реализован с помощью NSNetService и порты регистров в домене локальной сети. Зарегистрированное имя порта должно быть уникальным в локальном домене, не только локальном узле. Сервер имен только поддерживает TCP/IP (или IPv4 или IPv6) сокеты.

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

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

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

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.

Получение серверный объекта
  • sharedInstance + sharedInstance

    Возвращает совместно используемый сервер имен порта сокета.

    Объявление

    Objective C

    + (id)sharedInstance

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

    Единственный экземпляр NSSocketPortNameServer в котором Вы регистрируетесь и ищете NSSocketPort объекты.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

Поиск Портов
  • portForName: - portForName:

    Ищет и возвращает порт, зарегистрированный под указанным именем на локальном узле.

    Объявление

    Objective C

    - (NSPort *)portForName:(NSString *)portName

    Параметры

    portName

    Имя требуемого порта.

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

    Порт связался с portName на локальном узле. Возвраты nil если не существует никакой такой порт.

    Обсуждение

    Вызывает portForName:host:nameServerPortNumber: с nil как имя хоста и 0 как номер порта сервера имен.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

  • portForName:host: - portForName:host:

    Ищет и возвращает порт, зарегистрированный под указанным именем на указанном узле.

    Объявление

    Objective C

    - (NSPort *)portForName:(NSString *)portName host:(NSString *)hostName

    Параметры

    portName

    Имя требуемого порта.

    hostName

    Имя узла. hostName имя Интернет-домена (например, “sales.anycorp.com”). Если hostName nil или пустой, локальный узел проверяется.

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

    Порт связался с portName на узле hostName. Возвраты nil если не существует никакой такой порт.

    Обсуждение

    Вызывает portForName:host:nameServerPortNumber: с 0 как номер порта сервера имен.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

  • portForName:host:nameServerPortNumber: - portForName:host:nameServerPortNumber:

    Ищет и возвращает порт, зарегистрированный под указанным именем на указанном узле.

    Объявление

    Objective C

    - (NSPort *)portForName:(NSString *)portName host:(NSString *)hostName nameServerPortNumber:(uint16_t)portNumber

    Параметры

    portName

    Имя требуемого порта.

    hostName

    Имя узла. hostName имя Интернет-домена (например, “sales.anycorp.com”) или IP-адрес (IPv4 или IPv6). Если hostName nil или пустой, локальный узел проверяется. Если hostName @”*”, все узлы в локальной сети проверяются.

    portNumber

    portNumber параметр проигнорирован.

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

    Порт связался с portName на узле hostName. Возвраты nil если не существует никакой такой порт.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – portForName:
    – portForName:host:
    – registerPort:name:nameServerPortNumber:

Регистрация и удаление портов
  • registerPort:name: - registerPort:name:

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

    Объявление

    Objective C

    - (BOOL)registerPort:(NSPort *)port name:(NSString *)portName

    Параметры

    port

    Порт для предоставления доступа доступным.

    portName

    Имя для порта.

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

    YEStrue в случае успеха, NOfalse иначе.

    Обсуждение

    Вызывает registerPort:name:nameServerPortNumber: с 0 как номер порта сервера имен.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.2 и позже.

  • registerPort:name:nameServerPortNumber: - registerPort:name:nameServerPortNumber:

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

    Объявление

    Objective C

    - (BOOL)registerPort:(NSPort *)port name:(NSString *)portName nameServerPortNumber:(uint16_t)portNumber

    Параметры

    port

    Порт для предоставления доступа доступным.

    portName

    Имя для порта.

    portNumber

    portNumber параметр проигнорирован.

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

    YEStrue в случае успеха, NOfalse иначе.

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

    Если Ваше приложение уже зарегистрировало порт под именем portName, этот метод заменяет его port.

    Если локальному домену уже назвали порт portName зарегистрированный, этот метод мог возвратиться YEStrue прежде чем коллизия имени обнаруживается. Для обнаружения потенциальной коллизии имени можно вызвать portForName:host: с a host параметр @"*" протестировать если portName уже взят. Это, однако, оставляет состояние состязания в чем, другой процесс может зарегистрировать порт под portName после portForName:host: возвраты, но перед регистрацией port. Если это - недопустимый риск для Вашего приложения, можно также вызвать portForName:host: некоторый конечный промежуток времени после регистрации Вашего порта, чтобы протестировать, если Вы возвращаете тот же порт.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – portForName:host:nameServerPortNumber:

  • removePortForName: - removePortForName:

    Не регистрирует порт для имени на локальном узле.

    Объявление

    Objective C

    - (BOOL)removePortForName:(NSString *)portName

    Параметры

    portName

    Имя порта, чтобы не зарегистрироваться.

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

    YEStrue в случае успеха, иначе NOfalse.

    Обсуждение

    Если работа успешна, порт больше не может искаться с помощью имени portName. Другие приложения, уже имеющие ссылку на порт, могут продолжать использовать его, пока это не становится недопустимым.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

Конфигурирование номера порта по умолчанию
  • defaultNameServerPortNumber - defaultNameServerPortNumber

    Возвращается номер порта раньше связывался с сервером имен.

    Объявление

    Objective C

    @property uint16_t defaultNameServerPortNumber

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

    Номер порта раньше связывался с сервером имен. Это значение в настоящее время игнорируется.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setDefaultNameServerPortNumber:

  • setDefaultNameServerPortNumber: - setDefaultNameServerPortNumber:

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

    Объявление

    Objective C

    @property uint16_t defaultNameServerPortNumber

    Параметры

    portNumber

    Новый номер порта раньше связывался с сервером имен. Это значение в настоящее время игнорируется.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – defaultNameServerPortNumber