StreamSocket.Control Property

Reference

Definition

Namespace:: Windows.Networking.Sockets

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Gets socket control data on a StreamSocket object.

public:
 property StreamSocketControl ^ Control { StreamSocketControl ^ get(); };

StreamSocketControl Control();

public StreamSocketControl Control { get; }

var streamSocketControl = streamSocket.control;

Public ReadOnly Property Control As StreamSocketControl

Property Value

StreamSocketControl

Socket control data on a StreamSocket object.

Windows requirements

App capabilities

ID_CAP_NETWORKING [Windows Phone]

Remarks

The Control property gets the StreamSocketControl instance associated with a StreamSocket object.

A StreamSocketControl object is automatically created with the parent StreamSocket object. The StreamSocketControl instance can then be used to get or set control data used by the StreamSocket object. These properties on the StreamSocketControl instance include the following:

IgnorableServerCertificateErrors - Get a vector of SSL server errors to ignore when making an SSL connection with a StreamSocket object.
KeepAlive - A value that indicates whether keep-alive packets are sent to the remote destination on a StreamSocket object.
NoDelay - A value that indicates whether the Nagle algorithm is used on a StreamSocket object.
OutboundUnicastHopLimit - The hop limit on an outbound packet sent to a unicast IP address by the StreamSocket object.
OutboundBufferSizeInBytes - - The size, in bytes, of the send buffer to be used for sending data on a StreamSocket object.
QualityOfService - The quality of service on a StreamSocket object.

Any changes to the property values on the StreamSocketControl must be set before the StreamSocket is connected. As a result if you need to make changes to the IgnorableServerCertificateErrors, KeepAlive, NoDelay, OutboundBufferSizeInBytes , OutboundUnicastHopLimit, or QualityOfService properties, then these changes must occur before a successful call to one of the ConnectAsync methods on the StreamSocket.

Applies to