-api-id | -api-type |
---|---|
M:Windows.Networking.Sockets.StreamSocket.ConnectAsync(Windows.Networking.HostName,System.String,Windows.Networking.Sockets.SocketProtectionLevel) |
winrt method |
Starts an asynchronous operation on a StreamSocket object to connect to a remote destination specified by a remote hostname, a remote service name, and a SocketProtectionLevel.
The hostname or IP address of the remote network destination. For Bluetooth RFCOMM, this is a MAC address.
The service name or TCP port number of the remote network destination. For Bluetooth RFCOMM, this is the Bluetooth address.
The protection level that represents the integrity and encryption for the StreamSocket object.
An asynchronous connect operation on a StreamSocket object.
The remoteHostName and remoteServiceName parameters must be provided. If the remoteHostName is null or the remoteServiceName is null or an empty string, an error will occur.
When the protectionLevel parameter is set to a value that requires SSL or TLS, the socket connect operation may not timeout if the remote network destination does not support SSL or TLS. This can occur if initial connect operation succeeds but the remote host does not terminate the connection during the SSL handshake. To protect against this situation, an app should set a timeout on the connect operation when requesting SSL/TLS and abort the operation if the timeout expires. For more information on setting a timeout using JavaScript on socket operations, see How to set timeouts on socket operations . For more information on setting a timeout using VB, C#, or C++ on socket operations, see How to set timeouts on socket operations .
In a UWP app, the StreamSocket class supports connecting to a remote endpoint when proxies are required to complete the connection. This support for proxies is automatic and transparent to the app. For more detailed information, see the remarks on Support for proxies in the StreamSocket class reference.
In a Windows Phone 8.x app, the StreamSocket class does not provide automatic support for proxies.
How to set timeouts on socket operations , How to set timeouts on socket operations , ConnectAsync(EndpointPair), ConnectAsync(HostName, String), ConnectAsync(EndpointPair, SocketProtectionLevel), ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter), HostName, SocketProtectionLevel
internetClientServer, privateNetworkClientServer, ID_CAP_NETWORKING [Windows Phone]