Partager via


StreamSocketListenerControl Classe

Définition

Fournit des données de contrôle de socket sur un objet StreamSocketListener .

public ref class StreamSocketListenerControl sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StreamSocketListenerControl final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StreamSocketListenerControl
Public NotInheritable Class StreamSocketListenerControl
Héritage
Object Platform::Object IInspectable StreamSocketListenerControl
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application
ID_CAP_NETWORKING [Windows Phone]

Remarques

La classe StreamSocketListenerControl permet d’accéder aux données de contrôle de socket avancées sur un objet StreamSocketListener .

Un objet StreamSocketListenerControl est créé automatiquement avec l’objet StreamSocketListener parent. La propriété StreamSocketListener.Control permet d’accéder à l’objet StreamSocketListenerControl associé.

Toutes les modifications apportées aux valeurs de propriété StreamSocketListenerControl doivent être définies avant que le StreamSocketListener soit lié. Les modifications apportées à la propriété QualityOfService doivent donc être définies avant que la méthode BindServiceNameAsync ou BindEndpointAsync soit appelée sur le StreamSocketListener.

L’exemple suivant crée un StreamSocketListener, puis montre comment définir la propriété QualityOfService sur LowLatency. Une fois cette opération effectuée, l’application peut lier et écouter le StreamSocketListener.

using Windows.Networking.Sockets;

StreamSocketListener listenerSocket = new StreamSocketListener();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
var currentSetting = listenerSocket.Control.QualityOfService;

// Set QualityOfService to LowLatency.
listenerSocket.Control.QualityOfService = SocketQualityOfService.LowLatency;

// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::StreamSocketListener listenerSocket;

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting{ listenerSocket.Control().QualityOfService() };

// Set QualityOfService to LowLatency.
listenerSocket.Control().QualityOfService(Windows::Networking::Sockets::SocketQualityOfService::LowLatency);

// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.
using namespace Windows::Networking::Sockets;

StreamSocketListener^ listenerSocket = ref new StreamSocketListener();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
auto currentSetting = listenerSocket->Control->QualityOfService;

// Set QualityOfService to LowLatency.
listenerSocket->Control->QualityOfService = SocketQualityOfService::LowLatency;

// Now you can call the BindServiceNameAsync or BindEndpointAsync method to listen for connections.

Pour plus d’informations sur l’utilisation de StreamSocketListenerControl, consultez Utilisation des contrôles de socket avancés.

Propriétés

KeepAlive

Valeur qui indique si les paquets keep-alive doivent être envoyés sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener .

NoDelay

Valeur qui indique si l’algorithme Nagle est utilisé sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener .

OutboundBufferSizeInBytes

Taille, en octets, de la mémoire tampon d’envoi à utiliser pour l’envoi de données sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener .

OutboundUnicastHopLimit

Limite de tronçon sur un paquet sortant envoyé à une adresse IP unicast par l’objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener .

QualityOfService

Qualité de service à définir sur un objet StreamSocket créé lorsqu’une connexion est reçue par l’objet StreamSocketListener .

S’applique à

Voir aussi