Returns the current network information for a given network interface.
- iOS 4.1+
The network interface name.
A dictionary containing the interface’s current network info, provided certain requirements are met (see Discussion section). If the requirements are not met, the return value is either a dictionary with pseudo values, or
NULL. If an error occurs, the return value is
The returned dictionary contains the following keys and values:
Ownership of the returned dictionary follows the The Create Rule. You are responsible for releasing the returned value.
The requesting app must meet one of the following requirements:
The app uses Core Location, and has the user’s authorization to use location information.
The app uses the
NEHotspotAPI to configure the current Wi-Fi network.
The app has active VPN configurations installed.
An app that fails to meet any of the above requirements receives the following return value:
An app linked against iOS 12 or earlier receives a dictionary with pseudo-values. In this case, the SSID is
WLANin the China region), and the BSSID is
00: 00: 00: 00: 00
An app linked against iOS 13 or later receives
This function returns
NULL for iPad apps running in macOS.