SCNetworkConnectionCopyExtendedStatus(_:)
Returns the extended status of the connection.
Declaration
func SCNetworkConnectionCopyExtendedStatus(_ connection: SCNetworkConnection) -> CFDictionary?Parameters
- connection:
The network connection.
Return Value
The status dictionary, or NULL if an error occurred (use the SCError() function to retrieve the specific error).
Discussion
An extended status dictionary contains specific dictionaries describing the status for each subcomponent of the service. For example, a status dictionary contains the following sub-dictionaries, keys, and values:
Sub-dictionary | Key | Value |
|---|---|---|
IPv4 |
| The assigned IP address |
PPP |
| The PPP-specific status (see Scnetworkconnectionpppstatus for possible values) |
| Available when the status is “Disconnected” and contains the last error associated with connecting or disconnecting. | |
| The time when the connection was established. | |
Modem |
| The speed of the modem connection in bits per second. |
Other dictionaries can be present for PPoE, PPTP, and L2TP.
The status dictionary may be extended in the future to contain additional information.