Windows.Networking Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit l’accès aux noms d’hôte et aux points de terminaison utilisés par les applications réseau.
Classes
| Nom | Description |
|---|---|
| EndpointPair |
Représente un jumelage d’identificateurs d’hôte/de service local et distant (nom d’hôte ou ADRESSE IP plus nom de service ou port) utilisé pour lancer ou décrire une connexion réseau. |
| HostName |
Représente un nom d’hôte ou une adresse IP (domaine, IPv4, IPv6 ou Bluetooth) utilisé par Windows API réseau. |
Énumérations
| Nom | Description |
|---|---|
| DomainNameType |
Type de domaine de l’objet HostName lorsque HostNameType est un nom de domaine. |
| HostNameSortOptions |
Options pour la façon dont une liste d’objets EndpointPair est triée. |
| HostNameType |
Type d’un objet HostName . |
Remarques
Remarque
Compatibilité de l’infrastructure d’application : Le Windows. Les API réseau sont disponibles pour les applications SDK d'application Windows (WinUI 3) et les applications de bureau Win32, et non seulement les applications UWP. Les applications de bureau peuvent utiliser des objets HostName et EndpointPair via C#/WinRT ou C++/WinRT. Pour les applications de bureau empaquetées, les fonctionnalités réseau sont déclarées dans le manifeste de l’application de la même façon que pour les applications UWP. Par défaut, les applications de bureau non empaquetées disposent d’un accès réseau illimité. Pour plus d’informations, consultez Appeler Windows Runtime API dans les applications de bureau.
Le Windows. L’espace de noms réseau fournit des classes utilisées pour initialiser et fournir des données pour un nom d’hôte ou une adresse IP et pour une paire de points de terminaison réseau utilisée dans les applications réseau. Les objets HostName et EndpointPair sont utilisés par de nombreuses classes dans d’autres espaces de noms associés. Ces options en question sont les suivantes :
- Classes dans le Windows. Espace de noms Networking.Sockets utilisé pour les applications réseau à l’aide de sockets et de WebSockets.
- Classe NetworkInformation dans le Windows. Espace de noms Networking.Connectivity.
Sur Windows Server 2012, le Windows.Networking.dll qui implémente les classes dans le Windows. L’espace de noms réseau ne peut pas être chargé, sauf si la fonctionnalité Media Foundation est activée. Par conséquent, les applications utilisant des classes dans le Windows. L’espace de noms réseau échoue si la fonctionnalité Media Foundation est désactivée (valeur par défaut sur Windows Server 2012).
La fonctionnalité Media Foundation peut être activée sur Windows Server 2012 à l’aide de Gestionnaire de serveur ou en entrant la commande suivante dans une fenêtre CMD ou un script.
dism /online /enable-feature /featurename:ServerMediaFoundation L’utilisateur est invité à redémarrer une fois la fonctionnalité Media Foundation activée sur Windows Server 2012. Une fois l’ordinateur redémarré, les classes du Windows. L’espace de noms réseau fonctionne comme prévu.
Utilisation de l’isolation réseau
La fonctionnalité d’isolation réseau dans Windows permet à un développeur de contrôler entièrement l’accès réseau d’une application empaquetée (y compris les applications de bureau UWP et empaquetées SDK d'application Windows (WinUI 3). Toutes les applications ne peuvent pas nécessiter l’accès au réseau. Toutefois, pour ces applications, Windows fournit différents niveaux d’accès au réseau qui peuvent être activés en sélectionnant les fonctionnalités appropriées.
L’isolation réseau permet à un développeur de définir pour chaque application l’étendue de l’accès réseau requis. Une application sans l’étendue appropriée définie n’est pas empêchée d’accéder au type de réseau spécifié et à un type spécifique de requête réseau (demandes initiées par le client sortant ou à la fois des requêtes entrantes non sollicitées et des requêtes sortantes initiées par le client). La capacité à définir et à faire respecter l’isolement réseau garantit que, si une application vient à être compromise, elle ne peut accéder qu’aux réseaux auxquels elle s’est explicitement vu accorder l’accès. Cela réduit considérablement l’étendue de l’impact sur d’autres applications et sur Windows.
L’isolation réseau affecte toutes les méthodes et propriétés de la Windows. Networking.Sockets, Windows. Networking.BackgroundTransfer, Windows. Web.AtomPub et Windows. Espaces de noms Web.Syndication qui tentent d’accéder au réseau. Windows applique activement l’isolation réseau. Un appel à une méthode ou tout accès à une propriété dans ces espaces de noms qui entraîne l’échec de l’accès réseau en raison de l’isolation du réseau si la fonctionnalité réseau appropriée n’a pas été activée.
Les fonctionnalités réseau d’une application sont configurées dans le manifeste de l’application lorsque l’application est générée. Les fonctionnalités réseau sont généralement ajoutées à l’aide de Microsoft Visual Studio 2012 lors du développement de l’application. Les fonctionnalités réseau peuvent également être définies manuellement dans le fichier manifeste de l’application à l’aide d’un éditeur de texte.
Pour plus d’informations sur l’isolation réseau, consultez la procédure de configuration des fonctionnalités d’isolation réseau.