Function SCNetworkConnectionCopyExtendedStatus

Source
pub unsafe extern "C-unwind" fn SCNetworkConnectionCopyExtendedStatus(
    connection: &SCNetworkConnection,
) -> Option<CFRetained<CFDictionary>>
Available on crate feature SCNetworkConnection only.
Expand description

Returns the extended status of the connection. An extended status dictionary contains specific dictionaries describing the status for each subcomponent of the service.

For example, a status dictionary will contain the following sub-dictionaries, keys, and values:


```text
 
    IPv4  : Addresses      : the assigned IP address.
 
    PPP   : Status         : the PPP-specific status of type
                 SCNetworkConnectionPPPStatus.
 
        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/second.
 
    IPSec : Status         : the IPSec-specific status of type
                 SCNetworkConnectionIPSecStatus
 
        ConnectTime    : the time when the connection was
                 established.

```

Other dictionaries could be present for PPPoE, PPTP, and L2TP.

The status dictionary may be extended in the future to contain additional information.

Parameter connection: The SCNetworkConnection to obtain status from.

Returns: Returns the status dictionary. If NULL is returned, the error can be retrieved using the SCError function.