StreamSocketControl Klasse

Definition

Namespace:: Windows.Networking.Sockets

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Socketsteuerelementdaten für ein StreamSocket -Objekt bereit.

public ref class StreamSocketControl sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StreamSocketControl final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StreamSocketControl

Public NotInheritable Class StreamSocketControl

Vererbung: Object Platform::Object IInspectable StreamSocketControl

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Anforderungen	Beschreibung
Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	bluetooth.rfcomm

Hinweise

Die StreamSocketControl-Klasse bietet Zugriff auf erweiterte Socketsteuerungsdaten in einem StreamSocket-Objekt .

Ein StreamSocketControl-Objekt wird automatisch mit dem übergeordneten StreamSocket-Objekt erstellt. Die StreamSocket.Control-Eigenschaft bietet Zugriff auf das zugeordnete StreamSocketControl-Objekt.

Alle Änderungen an den Eigenschaftswerten für StreamSocketControl müssen festgelegt werden, bevor das StreamSocket verbunden ist. Als Ergebnis, wenn Sie Änderungen an den Eigenschaften "ClientCertificate", "IgnorableServerCertificateErrors", "KeepAlive", "NoDelay", " OutboundBufferSizeInBytes ", " OutboundUnicastHopLimit" oder " QualityOfService " vornehmen müssen, müssen diese Änderungen vor einem erfolgreichen Aufruf einer der ConnectAsync-Methoden im StreamSocket auftreten.

Verwenden Sie clientCertificate , um ein Clientzertifikat festzulegen, das verwendet werden soll, um sichere Verbindungen über das zugeordnete StreamSocket-Objekt herzustellen.

Im folgenden Beispiel wird ein StreamSocket erstellt und anschließend veranschaulicht, wie die NoDelay-Eigenschaft auf "false" festgelegt wird. Andere Eigenschaften können auf ähnliche Weise festgelegt werden. Nachdem dies erfolgt ist, kann die App das StreamSocket verbinden.

using Windows.Networking.Sockets;

StreamSocket clientSocket = new StreamSocket();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
bool currentSetting = clientSocket.Control.NoDelay;

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientSocket.Control.NoDelay = false;

// Now you can call the ConnectAsync method to connect the StreamSocket.

#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::StreamSocket clientSocket;

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
bool currentSetting{ clientSocket.Control().NoDelay() };

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientSocket.Control().NoDelay(false);

// Now you can call the ConnectAsync function to connect the StreamSocket.

using namespace Windows::Networking::Sockets;

StreamSocket^ clientSocket = ref new StreamSocket();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
bool currentSetting = clientSocket->Control->NoDelay;

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientSocket->Control->NoDelay = false;

// Now you can call the ConnectAsync method to connect the StreamSocket.

Weitere Informationen zur Verwendung von StreamSocketControl finden Sie unter Verwendung erweiterter Socketsteuerelemente.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1709	16299	MinProtectionLevel

Eigenschaften

Name	Beschreibung
ClientCertificate	Ruft das SSL/TLS-Clientzertifikat ab, das an den Server gesendet wird, wenn der Server ein Clientzertifikat anfordert, oder legt dieses fest.
IgnorableServerCertificateErrors	Ruft einen Vektor von SSL-Serverfehlern ab, die ignoriert werden, wenn eine SSL-Verbindung mit einem StreamSocket hergestellt wird.
KeepAlive	Ein Wert, der angibt, ob Keep-Alive-Pakete an das Remoteziel eines StreamSocket-Objekts gesendet werden.
MinProtectionLevel	Beschränkt die TLS-Protokollversion, die ausgehandelt wird, wenn der Entwickler die Methoden ConnectAsync() oder UpgradeToSslAsync() verwendet, die TLS erfordern.
NoDelay	Ein Wert, der angibt, ob der Nagle-Algorithmus für ein StreamSocket-Objekt verwendet wird.
OutboundBufferSizeInBytes	Die Größe des Sendepuffers in Bytes, der zum Senden von Daten in einem StreamSocket-Objekt verwendet werden soll.
OutboundUnicastHopLimit	Der Hopgrenzwert für ein ausgehendes Paket, das vom StreamSocket-Objekt an eine Unicast-IP-Adresse gesendet wird.
QualityOfService	Die Dienstqualität für ein StreamSocket-Objekt .
SerializeConnectionAttempts	Ein Wert, der angibt, ob bei mehreren Verbindungsversuchen die Versuche parallel oder seriell ausgeführt werden.

Gilt für:

Siehe auch

Feedback

War diese Seite hilfreich?