Condividi tramite


StreamSocketListenerControl Classe

Definizione

Fornisce i dati di controllo socket in un oggetto 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
Ereditarietà
Object Platform::Object IInspectable StreamSocketListenerControl
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app
ID_CAP_NETWORKING [Windows Phone]

Commenti

La classe StreamSocketListenerControl fornisce l'accesso ai dati di controllo socket avanzati in un oggetto StreamSocketListener .

Un oggetto StreamSocketListenerControl viene creato automaticamente con l'oggetto StreamSocketListener padre. La proprietà StreamSocketListener.Control fornisce l'accesso all'oggetto StreamSocketListenerControl associato.

Le modifiche apportate ai valori delle proprietà StreamSocketListenerControl devono essere impostate prima che streamSocketListener sia associato. Pertanto, le modifiche apportate alla proprietà QualityOfService devono essere impostate prima che il metodo BindServiceNameAsync o BindEndpointAsync venga chiamato nel metodo StreamSocketListener.

Nell'esempio seguente viene creato un oggetto StreamSocketListener e viene illustrato come impostare la proprietà QualityOfService su LowLatency. Al termine, l'app può eseguire l'associazione e l'ascolto in 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.

Per altre informazioni sull'uso di StreamSocketListenerControl, vedere Come usare i controlli socket avanzati.

Proprietà

KeepAlive

Valore che indica se i pacchetti keep-alive devono essere inviati in un oggetto StreamSocket creato quando una connessione viene ricevuta dall'oggetto StreamSocketListener .

NoDelay

Valore che indica se l'algoritmo Nagle viene usato in un oggetto StreamSocket creato quando una connessione viene ricevuta dall'oggetto StreamSocketListener .

OutboundBufferSizeInBytes

Dimensioni, in byte, del buffer di invio da usare per l'invio di dati in un oggetto StreamSocket creato quando una connessione viene ricevuta dall'oggetto StreamSocketListener .

OutboundUnicastHopLimit

Limite di hop su un pacchetto in uscita inviato a un indirizzo IP unicast dall'oggetto StreamSocket creato quando una connessione viene ricevuta dall'oggetto StreamSocketListener .

QualityOfService

Qualità del servizio da impostare su un oggetto StreamSocket creato quando una connessione viene ricevuta dall'oggetto StreamSocketListener .

Si applica a

Vedi anche