Freigeben über


ConnectionProfile Klasse

Definition

Stellt eine Netzwerkverbindung dar, die entweder das derzeit verbundene Netzwerk oder vorherige Netzwerkverbindungen umfasst. Stellt Informationen zu verbindungs- status und Konnektivitätsstatistiken bereit.

public ref class ConnectionProfile sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectionProfile final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectionProfile
Public NotInheritable Class ConnectionProfile
Vererbung
Object Platform::Object IInspectable ConnectionProfile
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die folgende Beispielfunktion veranschaulicht, wie Daten aus einem ConnectionProfile abgerufen werden.

function getConnectionProfileInfo(connectionProfile) {

     returnString += "Connection Cost Information:\n\r";
     returnString += "===============\n\r";
     var connectionCost = connectionProfile.getConnectionCost();
     returnString += "Cost Type: " + getCostType(connectionCost.networkCostType) + "\n\r";
     returnString += "Roaming: " + connectionCost.roaming + "\n\r";
     returnString += "Over Datalimit: " + connectionCost.overDataLimit + "\n\r";
     returnString += "Approaching Datalimit: " + connectionCost.approachingDataLimit + "\n\r";
}

Weitere Beispiele für die Implementierung dieser Klassenmethoden für den Zugriff auf Verbindungsinformationen finden Sie unter Schnellstart: Abrufen von Netzwerkverbindungsinformationen.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1709 16299 GetProviderNetworkUsageAsync
1809 17763 CanDelete
1809 17763 TryDeleteAsync

Eigenschaften

CanDelete

Ruft einen Wert ab, der angibt, ob dieses Verbindungsprofil gelöscht werden kann. Dadurch kann ermittelt werden, ob TryDeleteAsync wahrscheinlich erfolgreich ist.

IsWlanConnectionProfile

Ruft einen Wert ab, der angibt, ob das Verbindungsprofil eine WLAN-Verbindung (WIFi) ist. Dadurch wird bestimmt, ob WlanConnectionProfileDetails NULL ist.

IsWwanConnectionProfile

Ruft einen Wert ab, der angibt, ob das Verbindungsprofil eine WWAN-Verbindung (Mobile) ist. Dadurch wird bestimmt, ob WwanConnectionProfileDetails NULL ist.

NetworkAdapter

Ruft das -Objekt ab, das den Netzwerkadapter darstellt, der Konnektivität für die Verbindung bereitstellt.

NetworkSecuritySettings

Ruft die Sicherheitseinstellungen für das Netzwerk ab.

ProfileName

Ruft den Namen des Verbindungsprofils ab.

ServiceProviderGuid

Ruft die ID des Netzbetreibers ab, der das Verbindungsprofil bereitgestellt hat.

WlanConnectionProfileDetails

Ruft ein WlanConnectionProfileDetails-Objekt ab, das eine Methode zum Abrufen von Informationen bereitstellt, die speziell für eine WLAN-Verbindung (WIFi) gelten.

WwanConnectionProfileDetails

Ruft ein WwanConnectionProfileDetails-Objekt ab, das die Eigenschaften und Methoden enthält, die zum Abrufen spezifischer Informationen für mobile Breitbandverbindungen verwendet werden.

Methoden

GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)

Ruft Netzwerknutzungsdaten für jede einzelne Anwendung ab.

GetConnectionCost()

Ruft die Kosteninformationen für die Verbindung ab.

GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates)

Ruft eine Liste der ConnectivityInterval-Objekte ab, die den Zeitstempel für den Beginn der Netzwerkverbindung und eine Zeitspanne für die Dauer dieser Verbindung angeben.

GetDataPlanStatus()

Ruft den aktuellen status des Datenplans ab, der der Verbindung zugeordnet ist.

GetDomainConnectivityLevel()

Ruft die aktuelle domänenauthentifizierung status für eine Netzwerkverbindung ab. Mögliche Werte werden von DomainConnectivityLevel definiert.

GetLocalUsage(DateTime, DateTime)

Hinweis

GetLocalUsage kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen GetNetworkUsageAsync.

Ruft die geschätzte Datennutzung für eine Verbindung während eines bestimmten Zeitraums ab.

GetLocalUsage(DateTime, DateTime, RoamingStates)

Hinweis

GetLocalUsage kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen GetNetworkUsageAsync.

Ruft die geschätzte Datennutzung für eine Verbindung über einen bestimmten Zeitraum und roamingstatus ab.

GetNetworkConnectivityLevel()

Ruft die Netzwerkkonnektivitätsebene für diese Verbindung ab. Dieser Wert gibt an, welche Netzwerkressourcen derzeit verfügbar sind.

GetNetworkNames()

Ruft Namen ab, die dem Netzwerk zugeordnet sind, mit dem die Verbindung derzeit hergestellt wird.

GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates)

Ruft eine Liste des geschätzten Datenverkehrs und der Verbindungsdauer für einen bestimmten Zeitraum für einen bestimmten Netzwerknutzungszustand ab.

DataUsageGranularity wird verwendet, um die gewünschte Granularität der zurückgegebenen Daten anzugeben und wirkt sich auf die Länge der zurückgegebenen Liste aus. NetworkUsageStates wird verwendet, um die gewünschte Netzwerknutzungskonfiguration anzugeben.

GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates)

Gibt die gesendeten und empfangenen Bytes für jede MCC- und MNC-Kombination zurück (die Kombination wird durch eine ProviderId dargestellt).

GetSignalBars()

Ruft einen Wert ab, der die aktuelle Anzahl von Signalbalken angibt, die von der Windows-Benutzeroberfläche für die Verbindung angezeigt werden.

IsDomainAuthenticatedBy(DomainAuthenticationKind)

Fragt ab, ob die angegebene Domänenauthentifizierungsmethode für dieses Verbindungsprofil erfolgreich war.

TryDeleteAsync()

Versucht asynchron, dieses Verbindungsprofil zu löschen. Der Vorgang kann erfolgreich sein oder nicht. Untersuchen Sie den Rückgabewert, um das Ergebnis des Vorgangs zu bestimmen.

Gilt für:

Weitere Informationen