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