StreamSocketListenerControl Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados de controle de soquete em um objeto 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
- Herança
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Funcionalidades do aplicativo |
ID_CAP_NETWORKING [Windows Phone]
|
Comentários
A classe StreamSocketListenerControl fornece acesso a dados avançados de controle de soquete em um objeto StreamSocketListener .
Um objeto StreamSocketListenerControl é criado automaticamente com o objeto StreamSocketListener pai. A propriedade StreamSocketListener.Control fornece acesso ao objeto StreamSocketListenerControl associado.
Todas as alterações nos valores da propriedade StreamSocketListenerControl devem ser definidas antes que StreamSocketListener seja associado. Portanto, as alterações na propriedade QualityOfService devem ser definidas antes que o método BindServiceNameAsync ou BindEndpointAsync seja chamado no StreamSocketListener.
O exemplo a seguir cria um StreamSocketListener e demonstra como definir a propriedade QualityOfService como LowLatency. Depois que isso for feito, o aplicativo poderá associar e escutar no 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.
Para obter mais informações sobre como usar StreamSocketListenerControl, consulte Como usar controles de soquete avançados.
Propriedades
KeepAlive |
Um valor que indica se os pacotes keep alive devem ser enviados em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener . |
NoDelay |
Um valor que indica se o algoritmo Nagle é usado em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener . |
OutboundBufferSizeInBytes |
O tamanho, em bytes, do buffer de envio a ser usado para enviar dados em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener . |
OutboundUnicastHopLimit |
O limite de salto em um pacote de saída enviado para um endereço IP unicast pelo objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener . |
QualityOfService |
A qualidade do serviço a ser definida em um objeto StreamSocket criado quando uma conexão é recebida pelo objeto StreamSocketListener . |