StreamSocketListenerControl Klasse
Definition
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.
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 StreamSocketListenerControlPublic NotInheritable Class StreamSocketListenerControl- Vererbung
- Attribute
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. |