StreamSocket.Control Property
Definition
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.
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 StreamSocketControlProperty Value
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.