StreamSocketListenerControl 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 StreamSocketListener-Objekt bereit.

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

Vererbung: Object Platform::Object IInspectable StreamSocketListenerControl

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

Hinweise

Die StreamSocketListenerControl-Klasse bietet Zugriff auf erweiterte Socketsteuerungsdaten für ein StreamSocketListener-Objekt .

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

Alle Änderungen an den Werten der StreamSocketListenerControl-Eigenschaft müssen festgelegt werden, bevor streamSocketListener gebunden wird. Daher müssen Änderungen an der QualityOfService-Eigenschaft festgelegt werden, bevor die BindServiceNameAsync - oder BindEndpointAsync-Methode auf dem StreamSocketListener aufgerufen wird.

Im folgenden Beispiel wird ein StreamSocketListener erstellt, und dann wird veranschaulicht, wie die QualityOfService-Eigenschaft auf LowLatency festgelegt wird. Danach kann die App den StreamSocketListener binden und lauschen.

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.

Weitere Informationen zur Verwendung von StreamSocketListenerControl finden Sie unter Verwenden erweiterter Socketsteuerelemente.

Eigenschaften

KeepAlive	Ein Wert, der angibt, ob Keep-Alive-Pakete für ein StreamSocket-Objekt gesendet werden sollen, das erstellt wird, wenn eine Verbindung vom StreamSocketListener-Objekt empfangen wird.
NoDelay	Ein Wert, der angibt, ob der Nagle-Algorithmus für ein StreamSocket-Objekt verwendet wird, das erstellt wird, wenn eine Verbindung vom StreamSocketListener-Objekt empfangen wird.
OutboundBufferSizeInBytes	Die Größe des Sendepuffers in Bytes, der zum Senden von Daten für ein StreamSocket-Objekt verwendet werden soll, das erstellt wird, wenn eine Verbindung vom StreamSocketListener-Objekt empfangen wird.
OutboundUnicastHopLimit	Das Hoplimit für ein ausgehendes Paket, das vom StreamSocket-Objekt an eine Unicast-IP-Adresse gesendet wird, die erstellt wird, wenn eine Verbindung vom StreamSocketListener-Objekt empfangen wird.
QualityOfService	Die Dienstqualität, die für ein StreamSocket-Objekt festgelegt werden soll, das erstellt wird, wenn eine Verbindung vom StreamSocketListener-Objekt empfangen wird.

Gilt für:

Freigeben über