<!--
{
  "availability" : [
    "macOS: 10.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SystemConfiguration",
  "identifier" : "/documentation/SystemConfiguration/SCNetworkConnectionCopyExtendedStatus(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "System Configuration"
    ],
    "preciseIdentifier" : "c:@F@SCNetworkConnectionCopyExtendedStatus"
  },
  "title" : "SCNetworkConnectionCopyExtendedStatus(_:)"
}
-->

# SCNetworkConnectionCopyExtendedStatus(_:)

Returns the extended status of the connection.

```
func SCNetworkConnectionCopyExtendedStatus(_ connection: SCNetworkConnection) -> CFDictionary?
```

## Parameters

`connection`

The network connection.

## Return Value

The status dictionary, or `NULL` if an error occurred (use the [`SCError()`](/documentation/SystemConfiguration/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          |`Addresses`   |The assigned IP address                                                                                                                                 |
|PPP           |`Status`      |The PPP-specific status (see ``doc://com.apple.systemconfiguration/documentation/SystemConfiguration/SCNetworkConnectionPPPStatus`` for possible values)|
|              |`LastCause`   |Available when the status is “Disconnected” and contains the last error associated with connecting or disconnecting.                                    |
|              |`ConnectTime` |The time when the connection was established.                                                                                                           |
|Modem         |`ConnectSpeed`|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.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)