Returns the current network information for a given network interface.
SDK
- iOS 4.1+
Framework
- System
Configuration
Declaration
CFDictionary Ref CNCopyCurrentNetworkInfo(CFString Ref interfaceName);
Parameters
interfaceNameThe network interface name.
Return Value
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 NULL.
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.
Discussion
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.Configuration 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
Wi-Fi(orWLANin the China region), and the BSSID is00:.00: 00: 00: 00: 00 An app linked against iOS 13 or later receives
NULL.
Important
To use this function, an app linked against iOS 12 or later must enable the Access WiFi Information capability in Xcode. For more information, see Access Wi. Calling this function without the entitlement always returns NULL when linked against iOS 12 or later.
This function returns NULL in Mac apps built with Mac Catalyst.