Windows.Networking Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bietet Zugriff auf Hostnamen und Endpunkte, die von Netzwerk-Apps verwendet werden.
Klassen
| Name | Beschreibung |
|---|---|
| EndpointPair |
Stellt eine Kopplung von lokalen und Remotehost-/Dienst-IDs (Hostname oder IP plus Dienstname oder Port) dar, die zum Initiieren oder Beschreiben einer Netzwerkverbindung verwendet werden. |
| HostName |
Stellt einen Hostnamen oder eine IP-Adresse (Domäne, IPv4, IPv6 oder Bluetooth) dar, die von Windows Netzwerk-APIs verwendet wird. |
Enumerationen
| Name | Beschreibung |
|---|---|
| DomainNameType |
Der Domänentyp des HostName-Objekts , wenn der HostNameType ein Domänenname ist. |
| HostNameSortOptions |
Optionen für die Sortierung einer Liste von EndpointPair-Objekten . |
| HostNameType |
Der Typ eines HostName-Objekts . |
Hinweise
Hinweis
App-Framework-Kompatibilität: Die Windows. Netzwerk-APIs sind für Windows App SDK (WinUI 3)-Apps und Win32-Desktop-Apps verfügbar, nicht nur UWP-Apps. Desktop-Apps können HostName - und EndpointPair-Objekte über C#/WinRT oder C++/WinRT verwenden. Für verpackte Desktop-Apps werden Netzwerkfunktionen im App-Manifest genauso deklariert wie für UWP-Apps. Entpackte Desktop-Apps haben standardmäßig uneingeschränkten Netzwerkzugriff. Ausführliche Informationen finden Sie unter Aufrufen von Windows-Runtime-APIs in Desktop-Apps.
Die Windows. Der Netzwerknamespace stellt Klassen bereit, die zum Initialisieren und Bereitstellen von Daten für einen Hostnamen oder eine IP-Adresse und für ein Netzwerkendpunktpaar verwendet werden, das in Netzwerk-Apps verwendet wird. Die HostName - und EndpointPair-Objekte werden von vielen Klassen in anderen verwandten Namespaces verwendet. Hierzu gehört Folgendes:
- Kurse im Windows. Networking.Sockets-Namespace, der für Netzwerk-Apps mit Sockets und WebSockets verwendet wird.
- Die NetworkInformation-Klasse im Windows. Networking.Connectivity-Namespace.
Auf Windows Server 2012 wird die Windows.Networking.dll, die die Klassen im Windows implementiert. Netzwerknamespace kann nicht geladen werden, es sei denn, das Media Foundation-Feature ist aktiviert. Daher verwenden Apps Klassen im Windows. Netzwerknamespace schlägt fehl, wenn das Media Foundation-Feature deaktiviert ist (der Standardwert für Windows Server 2012).
Das Media Foundation-Feature kann auf Windows Server 2012 mithilfe von Server-Manager oder durch Eingabe des folgenden Befehls in ein CMD-Fenster oder ein Skript aktiviert werden.
dism /online /enable-feature /featurename:ServerMediaFoundation Der Benutzer wird aufgefordert, einen Neustart durchzuführen, nachdem das Media Foundation-Feature auf Windows Server 2012 aktiviert wurde. Nachdem der Computer neu gestartet wurde, werden klassen im Windows. Der Netzwerknamespace funktioniert wie erwartet.
Verwenden der Netzwerkisolation
Mit dem Netzwerkisolationsfeature in Windows kann ein Entwickler den Netzwerkzugriff einer verpackten App (einschließlich UWP und verpackter Windows App SDK (WinUI 3)-Desktop-Apps vollständig steuern. Nicht alle Apps erfordern möglicherweise Zugriff auf das Netzwerk. Für apps, die dies tun, bietet Windows jedoch unterschiedliche Zugriffsebenen auf das Netzwerk, die durch Auswahl geeigneter Funktionen aktiviert werden können.
Die Netzwerkisolation ermöglicht es einem Entwickler, für jede App den Umfang des erforderlichen Netzwerkzugriffs zu definieren. Eine App ohne den entsprechenden definierten Bereich wird daran gehindert, auf den angegebenen Netzwerktyp und einen bestimmten Netzwerkanforderungstyp zuzugreifen (ausgehende, vom Client initiierte Anforderungen oder sowohl eingehende nicht angeforderte Anforderungen als auch ausgehende, vom Client initiierte Anforderungen). Die Möglichkeit, Netzwerkisolation festzulegen und durchzusetzen, stellt sicher, dass eine App, selbst wenn sie kompromittiert wird, nur auf Netzwerke zugreifen kann, für die ihr ausdrücklich Zugriffsrechte gewährt wurden. Dadurch wird der Umfang der Auswirkungen auf andere Apps und auf Windows erheblich reduziert.
Die Netzwerkisolation wirkt sich auf alle Methoden und Eigenschaften im Windows aus. Networking.Sockets, Windows. Networking.BackgroundTransfer, Windows. Web.AtomPub und Windows. Web.Syndication-Namespaces, die versuchen, auf das Netzwerk zuzugreifen. Windows erzwingt aktiv die Netzwerkisolation. Ein Aufruf einer Methode oder eines Zugriffs auf eine Eigenschaft in diesen Namespaces, die zu Einem Netzwerkzugriff führt, kann aufgrund der Netzwerkisolation fehlschlagen, wenn die entsprechende Netzwerkfunktion nicht aktiviert wurde.
Die Netzwerkfunktionen für eine App werden im App-Manifest konfiguriert, wenn die App erstellt wird. Netzwerkfunktionen werden in der Regel mithilfe von Microsoft Visual Studio 2012 beim Entwickeln der App hinzugefügt. Netzwerkfunktionen können auch manuell in der App-Manifestdatei mithilfe eines Text-Editors festgelegt werden.
Ausführlichere Informationen zur Netzwerkisolation finden Sie unter " Konfigurieren von Netzwerkisolationsfunktionen".