StreamSocketListenerControl Класс

Определение

Предоставляет данные управления сокетом для объекта 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
Наследование
Object Platform::Object IInspectable StreamSocketListenerControl
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)
Возможности приложения
ID_CAP_NETWORKING [Windows Phone]

Комментарии

Класс StreamSocketListenerControl предоставляет доступ к расширенным данным управления сокетом в объекте StreamSocketListener .

Объект StreamSocketListenerControl создается автоматически с родительским объектом StreamSocketListener . Свойство StreamSocketListener.Control предоставляет доступ к связанному объекту StreamSocketListenerControl.

Все изменения значений свойств StreamSocketListenerControl должны быть заданы перед привязкой StreamSocketListener . Поэтому изменения в свойстве QualityOfService должны быть заданы перед вызовом метода BindServiceNameAsync или BindEndpointAsync в StreamSocketListener.

В следующем примере создается StreamSocketListener, а затем показано, как задать для свойства QualityOfService значение LowLatency. После этого приложение сможет привязать и прослушивать 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.

Дополнительные сведения об использовании StreamSocketListenerControl см. в статье Использование расширенных элементов управления сокетом.

Свойства

KeepAlive

Значение типа , указывающее, следует ли отправлять пакеты keep-alive в объект StreamSocket , созданный при получении подключения объектом StreamSocketListener .

NoDelay

Значение типа , указывающее, используется ли алгоритм Nagle в объекте StreamSocket , созданном при получении соединения объектом StreamSocketListener .

OutboundBufferSizeInBytes

Размер (в байтах) буфера отправки, используемого для отправки данных в объекте StreamSocket , созданном при получении соединения объектом StreamSocketListener .

OutboundUnicastHopLimit

Ограничение прыжка для исходящего пакета, отправленного на одноадресный IP-адрес объектом StreamSocket , созданным при получении подключения объектом StreamSocketListener .

QualityOfService

Качество обслуживания для объекта StreamSocket , созданного при получении подключения объектом StreamSocketListener .

Применяется к

См. также раздел