StreamSocketControl Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données de contrôle de socket sur un objet StreamSocket .
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
- Héritage
- Attributs
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Fonctionnalités de l’application |
bluetooth.rfcomm
ID_CAP_NETWORKING [Windows Phone]
|
La classe StreamSocketControl permet d’accéder aux données avancées du contrôle de socket sur un objet StreamSocket .
Un objet StreamSocketControl est créé automatiquement avec l’objet StreamSocket parent. La propriété StreamSocket.Control permet d’accéder à l’objet StreamSocketControl associé.
Toute modification apportée aux valeurs de propriété sur StreamSocketControl doit être définie avant que streamSocket ne soit connecté. Par conséquent, si vous devez apporter des modifications aux propriétés ClientCertificate, IgnorableServerCertificateErrors, KeepAlive, NoDelay, OutboundBufferSizeInBytes , OutboundUnicastHopLimit ou QualityOfService , ces modifications doivent se produire avant un appel réussi à l’une des méthodes ConnectAsync sur streamSocket.
Utilisez ClientCertificate pour définir un certificat client à utiliser pour établir des connexions sécurisées sur l’objet StreamSocket associé.
L’exemple suivant crée un StreamSocket, puis montre comment définir la propriété NoDelay sur false. D’autres propriétés peuvent être définies de la même manière. Une fois cette opération effectuée, l’application peut connecter streamSocket.
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.
Pour plus d’informations sur l’utilisation de StreamSocketControl, consultez Utilisation des contrôles de socket avancés.
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1709 | 16299 | MinProtectionLevel |
Client |
Obtient ou définit le certificat SSL/TLS client qui sera envoyé au serveur si le serveur demande un certificat client. |
Ignorable |
Obtenez un vecteur d’erreurs de serveur SSL à ignorer lors de l’établissement d’une connexion SSL avec un StreamSocket. |
Keep |
Valeur qui indique si les paquets keep-alive sont envoyés à la destination distante sur un objet StreamSocket . |
Min |
Limite la version du protocole TLS qui sera négociée lorsque le développeur utilise les méthodes ConnectAsync() ou UpgradeToSslAsync() qui nécessitent TLS. |
No |
Valeur qui indique si l’algorithme Nagle est utilisé sur un objet StreamSocket . |
Outbound |
Taille, en octets, de la mémoire tampon d’envoi à utiliser pour envoyer des données sur un objet StreamSocket . |
Outbound |
Limite de tronçons sur un paquet sortant envoyé à une adresse IP de monodiffusion par l’objet StreamSocket . |
Quality |
Qualité de service sur un objet StreamSocket . |
Serialize |
Valeur qui indique si, lorsque plusieurs tentatives de connexion sont effectuées, les tentatives sont effectuées en parallèle ou en série. |