CWInterface

Инкапсулирует интерфейс IEEE 802.11.

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

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

NSObject
CWInterface

NSObject
CWInterface

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import CoreWLAN

Objective C

@import CoreWLAN;

Доступность

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

Установка интерфейсных параметров


    
    setPairwiseMasterKey (_: ошибка:)
    - setPairwiseMasterKey:error:

Устанавливает интерфейсный попарный главный ключ (PMK).

Объявление

Swift

func setPairwiseMasterKey(_ key: NSData!, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)setPairwiseMasterKey:(NSData *)key error:(out NSError **)error

Параметры

key

Объект NSData, содержащий попарный главный ключ (PMK).


      error

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

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

Булево значение, которое укажет, произошел ли отказ во время выполнения. YES указывает, что не произошла никакая ошибка.

Обсуждение

ключ должен быть 32 октетами. Если ключ является нолем, этот метод очищает PMK для интерфейса.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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


    
    setPower (_: ошибка:)
    - setPower:error:

Устанавливает интерфейсное состояние электропитания.

Объявление

Swift

func setPower(_ power: Bool, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)setPower:(BOOL)power error:(out NSError **)error

Параметры


      power

Булево значение, соответствующее состоянию электропитания. НЕТ указывает состояние «OFF».


      error

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

Обсуждение

Эта работа может потребовать пароля администратора.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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


    
    setWEPKey (_: flags:index:error:)
    - setWEPKey:flags:index:error:

Устанавливает интерфейсный WEP-ключ.

Объявление

Swift

func setWEPKey(_ key: NSData!, flags flags: CWCipherKeyFlags, index index: Int, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)setWEPKey:(NSData *)key flags:(CWCipherKeyFlags)flags index:(NSInteger)index error:(out NSError **)error

Параметры

`key`	Объект NSData, содержащий WEP-ключ.
`flags`	Указание NSUInteger, которое ключ шифра отмечает для использования для указанного ключа.
`index`	Указание NSUInteger, которое ключ по умолчанию индексирует для использования для указанного ключа.
`error`	Объект NSError, переданный ссылкой, которая будет заполнена с кодом ошибки и описанием ошибки, если ошибка произойдет во время выполнения этого метода. Этот параметр является дополнительным и может быть передан как ноль.

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

Обсуждение

ключ должен быть 5 октетами для WEP 40 или 13 октетами для WEP 104. Если ключ является нолем, этот метод очищает WEP-ключ для интерфейса. индекс должен соответствовать ключевому индексу 1-4 по умолчанию.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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


    
    setWLANChannel (_: ошибка:)
    - setWLANChannel:error:

Устанавливает интерфейсный канал.

Объявление

Swift

func setWLANChannel(_ channel: CWChannel!, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)setWLANChannel:(CWChannel *)channel error:(out NSError **)error

Параметры


      channel

Соответствие объекта CWChannel каналу.


      error

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

Обсуждение

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

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Сканирование для сетей


    
    scanForNetworksWithName (_: ошибка:)
    - scanForNetworksWithName:error:

Сканирования для сетей.

Объявление

Swift

func scanForNetworksWithName(_ networkName: String!, error error: NSErrorPointer) -> NSSet!

Objective C

- (NSSet *)scanForNetworksWithName:(NSString *)networkName error:(out NSError **)error

Параметры


      networkName

Имя (SSID) сети, для которой можно отсканировать.


      error

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

Ряд объектов CWNetwork.

Обсуждение

Если ssid параметр будет присутствовать, то направленное сканирование будет выполняться интерфейсом, иначе широковещательное сканирование будет выполняться. Этот метод блокирует на время сканирования.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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


    
    scanForNetworksWithSSID (_: ошибка:)
    - scanForNetworksWithSSID:error:

Сканирования для сетей.

Объявление

Swift

func scanForNetworksWithSSID(_ ssid: NSData!, error error: NSErrorPointer) -> NSSet!

Objective C

- (NSSet *)scanForNetworksWithSSID:(NSData *)ssid error:(out NSError **)error

Параметры


      ssid

SSID, для которого можно отсканировать.


      error

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

Ряд объектов CWNetwork.

Обсуждение

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Получение интерфейса

init (interfaceName:) - initWithInterfaceName: (OS X v10.10)

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

Объявление

Swift

init!(interfaceName name: String!)

Objective C

- (instancetype)initWithInterfaceName:(NSString *)name

Параметры

name

NSString представление имени BSD интерфейса WLAN.

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

Объект CWInterface, сконфигурированный для управления именованным интерфейсом CoreWLAN.

Обсуждение

Имя интерфейса должно быть в форме имени BSD (например, «en1»), и может быть передано в явно или получено от вызова до + (NSString *) supportedInterfaces. Если имя является нолем, метод возвращает объект CWInterface для основного интерфейса.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.10.
интерфейс + интерфейс (OS X v10.10)

Удобный метод для получения CWInterface возражает для интерфейса WLAN по умолчанию.

Объявление

Objective C

+ (instancetype)interface

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

Объект CWInterface.

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

Objective C

@import CoreWLAN;

Доступность

Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.10.
init (имя:) + interfaceWithName: (OS X v10.10)

Метод экземпляра для получения объекта CWInterface.

Объявление

Swift

convenience init!(name name: String!)

Objective C

+ (instancetype)interfaceWithName:(NSString *)name

Параметры

name

NSString представление имени BSD интерфейса WLAN.

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

Объект CWInterface, сконфигурированный для управления именованным интерфейсом CoreWLAN.

Обсуждение

Имя интерфейса должно быть в форме имени BSD (например, «en1»), и может быть передано в явно или получено от вызова до + (NSString *) supportedInterfaces. Если имя является нолем, метод возвращает объект CWInterface для основного интерфейса. Этот метод является определяемым инициализатором для класса CWInterface.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.10.

будучи всем присоединенным интерфейсы

interfaceNames () + interfaceNames (OS X v10.10)

Возвращает список имен BSD для интерфейсов WLAN, доступных на существующей системе.

Объявление

Swift

class func interfaceNames() -> NSSet!

Objective C

+ (NSSet *)interfaceNames

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

Объект NSSet, содержащий объекты NSString, представляющие имена интерфейса BSD.

Обсуждение

Возвращает NSArray объектов NSString, представляющих поддерживаемые имена интерфейса BSD WLAN, avaliable на существующей системе (т.е. «en1», «en2»). Если не будет никаких поддерживаемых интерфейсов для существующей системы, то этот метод возвратит пустой объект NSArray. Ноль возвратов в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.10.

Разъединение с сетью

разъедините () - разъединить

Разъединяет с текущей сетью.

Объявление

Swift

func disassociate()

Objective C

- (void)disassociate

Обсуждение

Если интерфейс не связан с сетью, этот метод не имеет никакого эффекта. Эта работа может потребовать пароля администратора.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Создание компьютера к компьютерным сетям


    
    startIBSSModeWithSSID (_: security:channel:password:error:)
    - startIBSSModeWithSSID:security:channel:password:error:

Создает от компьютера к компьютеру (оперативная) сеть с данным сетевым именем, типом безопасности и паролем на указанном канале.

Объявление

Swift

func startIBSSModeWithSSID(_ ssidData: NSData!, security security: CWIBSSModeSecurity, channel channel: Int, password password: String!, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)startIBSSModeWithSSID:(NSData *)ssidData security:(CWIBSSModeSecurity)security channel:(NSUInteger)channel password:(NSString *)password error:(out NSError **)error

Параметры

`name`	Сетевое имя. Этот параметр является дополнительным и может быть передан как ноль.
`security`	Тип безопасности, который будет использоваться.
`channel`	Канал, на котором будет создаваться сеть.
`password`	Пароль, который будет использоваться. Этот paramter не применим к аутентификации открытой системы.

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

Обсуждение

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

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Фиксация конфигурации


    
    commitConfiguration (_: authorization:error:)
    - commitConfiguration:authorization:error:

Фиксируйте конфигурацию для данного интерфейса WLAN.

Объявление

Swift

func commitConfiguration(_ configuration: CWConfiguration!, authorization authorization: SFAuthorization!, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)commitConfiguration:(CWConfiguration *)configuration authorization:(SFAuthorization *)authorization error:(out NSError **)error

Параметры

`configuration`	Конфигурация для фиксации.
`authorization`	SFAuthorization возражает для использования для авторизации фиксации. Этот параметр является дополнительным и может быть передан как ноль.
`error`	Объект NSError, переданный ссылкой, которая будет заполнена с кодом ошибки и описанием ошибки, если ошибка произойдет во время выполнения этого метода. Этот параметр является дополнительным и может быть передан как ноль.

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

Обсуждение

Этот метод требует, чтобы вызывающая сторона имела полномочия пользователя root или получила права администратора с параметром авторизации.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Соединение к сети


    
    associateToEnterpriseNetwork (_: identity:username:password:error:)
    - associateToEnterpriseNetwork:identity:username:password:error:

Подключения к данной корпоративной сети.

Объявление

Swift

func associateToEnterpriseNetwork(_ network: CWNetwork!, identity username: SecIdentity!, username password: String!, password identity: String!, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)associateToEnterpriseNetwork:(CWNetwork *)network identity:(SecIdentityRef)username username:(NSString *)password password:(NSString *)identity error:(out NSError **)error

Параметры

`network`	Сеть, к которой свяжется интерфейс.
`username`	Имя пользователя для использования для IEEE 802.1X аутентификация.
`password`	Пароль для использования для IEEE 802.1X аутентификация.
`identity`	Идентификационные данные для использования для IEEE 802.1X аутентификация. Содержит соответствующий клиентский сертификат.
`error`	Объект NSError, переданный ссылкой, которая будет заполнена с кодом ошибки и описанием ошибки, если ошибка произойдет во время выполнения этого метода. Этот параметр является дополнительным и может быть передан как ноль.

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

Обсуждение

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

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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


    
    associateToNetwork (_: password:error:)
    - associateToNetwork:password:error:

Партнеры к данной сети с помощью данного сетевого пароля.

Объявление

Swift

func associateToNetwork(_ network: CWNetwork!, password password: String!, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)associateToNetwork:(CWNetwork *)network password:(NSString *)password error:(out NSError **)error

Параметры

`network`	Сеть, к которой свяжется интерфейс.
`password`	Сетевой пароль или ключ. Требуемый для ассоциации к WEP, WPA Персональные, и Персональные сети WPA2.
`error`	Объект NSError, переданный ссылкой, которая будет заполнена с кодом ошибки и описанием ошибки, если ошибка произойдет во время выполнения этого метода. Этот параметр является дополнительным и может быть передан как ноль.

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

Обсуждение

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

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Прочие условия

wlanChannel () wlanChannel Свойство

Текущий канал для интерфейса.

Объявление

Swift

func wlanChannel() -> CWChannel!

Objective C

- (CWChannel *)wlanChannel

Обсуждение

Динамично запрашивает интерфейс для текущего канала. Ноль возвратов в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
transmitRate () transmitRate Свойство

Текущая скорость передачи (Мбит/с) для интерфейса.

Объявление

Swift

func transmitRate() -> Double

Objective C

- (double)transmitRate

Обсуждение

Динамично запрашивает интерфейс для текущей скорости передачи. Возвраты 0 в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
transmitPower () transmitPower Свойство

Текущая мощность передачи (mW) для интерфейса.

Объявление

Swift

func transmitPower() -> Int

Objective C

- (NSInteger)transmitPower

Обсуждение

Динамично запрашивает интерфейс для текущей мощности передачи. Возвраты 0 в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
supportedWLANChannels () supportedWLANChannels Свойство

Массив каналов поддерживается интерфейсом для активного кода страны.

Объявление

Swift

func supportedWLANChannels() -> NSSet!

Objective C

- (NSSet *)supportedWLANChannels

Обсуждение

Динамично запрашивает интерфейс для поддерживаемых каналов. Возвращает массив объектов CWChannel или ноль <я/> в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
ssidData () ssidData Свойство

Текущая служба установила идентификатор (SSID) для интерфейса, возвращенного как данные.

Объявление

Swift

func ssidData() -> NSData!

Objective C

- (NSData *)ssidData

Обсуждение

Динамично запрашивает интерфейс для текущего SSID. SSID является 1-32 октетами. Ноль возвратов в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
ssid () ssid Свойство

Текущая служба установила идентификатор (SSID) для интерфейса, закодированного как строка.

Объявление

Swift

func ssid() -> String!

Objective C

- (NSString *)ssid

Обсуждение

Динамично запрашивает интерфейс для текущего SSID. Ноль возвратов в случае ошибки, или если интерфейс не участвует в сети, или если SSID не может быть закодирован как допустимый UTF-8 или строка WinLatin1.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
serviceActive () serviceActive Свойство

Интерфейсу включили его соответствующую сетевую службу.

Объявление

Swift

func serviceActive() -> Bool

Objective C

- (BOOL)serviceActive

Обсуждение

Возвраты НЕ в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
безопасность () безопасность Свойство

Текущий режим безопасности для интерфейса.

Объявление

Swift

func security() -> CWSecurity

Objective C

- (CWSecurity)security

Обсуждение

Динамично запрашивает интерфейс для режима безопасности. Возвраты kCWSecurityUnknown в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
rssiValue () rssiValue Свойство

Текущее совокупное измерение полученной индикации мощности сигнала (RSSI) (dBm) для интерфейса.

Объявление

Swift

func rssiValue() -> Int

Objective C

- (NSInteger)rssiValue

Обсуждение

Динамично запрашивает интерфейс для текущего совокупного измерения RSSI. Возвраты 0 в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
включение питания () включение питания Свойство

Интерфейсное состояние электропитания установлено в «ON».

Объявление

Swift

func powerOn() -> Bool

Objective C

- (BOOL)powerOn

Обсуждение

Динамично запрашивает интерфейс для текущего состояния электропитания. Возвраты НЕ в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
noiseMeasurement () noiseMeasurement Свойство

Текущее совокупное измерение шума (dBm) для интерфейса.

Объявление

Swift

func noiseMeasurement() -> Int

Objective C

- (NSInteger)noiseMeasurement

Обсуждение

Динамично запрашивает интерфейс для текущего совокупного измерения шума. Возвраты 0 в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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

Имя BSD интерфейса.

Объявление

Swift

var interfaceName: String! { get }

Objective C

@property(readonly) NSString *interfaceName

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
interfaceMode () interfaceMode Свойство

Текущий режим для интерфейса.

Объявление

Swift

func interfaceMode() -> CWInterfaceMode

Objective C

- (CWInterfaceMode)interfaceMode

Обсуждение

Динамично запрашивает интерфейс для текущего режима. Возвраты kCWInterfaceModeNone в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
hardwareAddress () hardwareAddress Свойство

Аппаратное управление доступом к среде (MAC) адресуется для интерфейса, возвращенного как строка UTF-8.

Объявление

Swift

func hardwareAddress() -> String!

Objective C

- (NSString *)hardwareAddress

Обсуждение

Стандартный формат для печати адреса MAC 48 <00:00:00:00:00:00> используется для представления MAC-адреса как строки. Ноль возвратов в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
deviceAttached deviceAttached Доступный в OS X v10.7 через OS X v10.9 Свойство

Интерфейсу присоединили его соответствующие аппаратные средства.

Объявление

Objective C

@property(readonly, assign) BOOL deviceAttached

Обсуждение

Возвраты НЕ в случае ошибки.

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

Objective C

@import CoreWLAN;

Доступность

Доступный в OS X v10.7 через OS X v10.9.
код страны () код страны Свойство

Текущий код страны (3166-1:1997 ISO/IEC) для интерфейса.

Объявление

Swift

func countryCode() -> String!

Objective C

- (NSString *)countryCode

Обсуждение

Динамично запрашивает интерфейс для текущего кода страны. Ноль возвратов в случае ошибки, или если интерфейсом является OFF.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
конфигурация () конфигурация Свойство

Текущая конфигурация для данного интерфейса WLAN.

Объявление

Swift

func configuration() -> CWConfiguration!

Objective C

- (CWConfiguration *)configuration

Обсуждение

Ноль возвратов в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
cachedScanResults () cachedScanResults Свойство

Сети в настоящее время в кэше сканирования для интерфейса WLAN.

Объявление

Swift

func cachedScanResults() -> NSSet!

Objective C

- (NSSet *)cachedScanResults

Обсуждение

Ноль возвратов в случае ошибки.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.7 и позже.
bssid () bssid Свойство

Текущая базовая услуга установила идентификатор (BSSID) для интерфейса, возвращенного как строка UTF-8.

Объявление

Swift

func bssid() -> String!

Objective C

- (NSString *)bssid

Обсуждение

Динамично запрашивает интерфейс для текущего BSSID. Если интерфейс не участвует в сети, возвращает строку UTF-8, отформатированную как <00:00:00:00:00:00>, или ноль в случае ошибки, или.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

Доступный в OS X v10.6 и позже.
activePHYMode () activePHYMode Свойство

Текущие активные режимы PHY для интерфейса.

Объявление

Swift

func activePHYMode() -> CWPHYMode

Objective C

- (CWPHYMode)activePHYMode

Обсуждение

Динамично запрашивает интерфейс для текущего активного режима PHY. Возвраты kCWPHYModeNone в случае ошибки, или если интерфейс не участвует в сети.

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

Objective C

@import CoreWLAN;

Swift

import CoreWLAN

Доступность

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