StreamSocketControl Klasse

Referenz

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 Socketsteuerungsdaten 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

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 ID_CAP_NETWORKING [Windows Phone]

Hinweise

Die StreamSocketControl-Klasse bietet Zugriff auf erweiterte Socketsteuerungsdaten für ein 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 streamSocket verbunden wird. 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 erfolgen.

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

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. Danach kann die App eine Verbindung mit StreamSocket herstellen.

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 Verwenden erweiterter Socketsteuerelemente.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1709	16299	MinProtectionLevel

Eigenschaften

ClientCertificate	Ruft das SSL/TLS-Clientzertifikat ab, das an den Server gesendet wird, wenn der Server ein Clientzertifikat anfordert, oder legt es fest.
IgnorableServerCertificateErrors	Ruft einen Vektor von SSL-Serverfehlern ab, die beim Herstellen einer SSL-Verbindung mit einem StreamSocket ignoriert werden sollen.
KeepAlive	Ein -Wert, der angibt, ob Keep-Alive-Pakete an das Remoteziel eines StreamSocket-Objekts gesendet werden.
MinProtectionLevel	Schränkt die TLS-Protokollversion ein, 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 für ein StreamSocket-Objekt verwendet werden soll.
OutboundUnicastHopLimit	Das Hoplimit 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 die Versuche parallel oder seriell durchgeführt werden, wenn mehrere Verbindungsversuche durchgeführt werden.

Gilt für:

Freigeben über