Class

CWInterface

Encapsulates an IEEE 802.11 interface.

Declaration

@interface CWInterface : NSObject

Overview

Provides access to various WLAN interface parameters, and operations such as scanning for networks, association, and creating computer-to-computer (ad-hoc) networks.

Topics

Setting interface parameters

- setPairwiseMasterKey:error:

Sets the interface pairwise master key (PMK).

- setPower:error:

Sets the interface power state.

- setWEPKey:flags:index:error:

Sets the interface WEP key.

- setWLANChannel:error:

Sets the interface channel.

Scanning for networks

Getting an interface

- initWithInterfaceName:

Convenience method for getting an CWInterface object with the specified name.

Deprecated
+ interface

Convenience method for getting an CWInterface object for the default WLAN interface.

Deprecated
+ interfaceWithName:

An instance method for obtaining an CWInterface object.

Deprecated

Getting all attached interfaces

+ interfaceNames

Returns the list of BSD names for WLAN interfaces available on the current system.

Deprecated

Disassociating from a network

- disassociate

Disassociates from the current network.

Creating computer-to-computer networks

- startIBSSModeWithSSID:security:channel:password:error:

Creates a computer-to-computer (ad-hoc) network with the given network name, security type, and password on the specified channel.

Committing a configuration

- commitConfiguration:authorization:error:

Commit a configuration for the given WLAN interface.

Associating to a network

- associateToNetwork:password:error:

Associates to a given network using the given network passphrase.

Miscellaneous

- deviceAttached

The interface has its corresponding hardware attached.

Instance Properties

interfaceName

The BSD name of the interface.

Instance Methods

- activePHYMode

The current active PHY modes for the interface.

- bssid

The current basic service set identifier (BSSID) for the interface, returned as a UTF-8 string.

- cachedScanResults

The networks currently in the scan cache for the WLAN interface.

- configuration

The current configuration for the given WLAN interface.

- countryCode

The current country code (ISO/IEC 3166-1:1997) for the interface.

- hardwareAddress

The hardware media access control (MAC) address for the interface, returned as a UTF-8 string.

- interfaceMode

The current mode for the interface.

- noiseMeasurement

The current aggregate noise measurement (dBm) for the interface.

- powerOn

The interface power state is set to "ON".

- rssiValue

The current aggregate received signal strength indication (RSSI) measurement (dBm) for the interface.

- security

The current security mode for the interface.

- serviceActive

The interface has its corresponding network service enabled.

- ssid

The current service set identifier (SSID) for the interface, encoded as a string.

- ssidData

The current service set identifier (SSID) for the interface, returned as data.

- supportedWLANChannels

An array of channels supported by the interface for the active country code.

- transmitPower

The current transmit power (mW) for the interface.

- transmitRate

The current transmit rate (Mbps) for the interface.

- wlanChannel

The current channel for the interface.

Relationships

Inherits From