导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

StreamSocket.ConnectAsync(EndpointPair, SocketProtectionLevel) Method

启动 StreamSocket 对象连接到被指定为 EndpointPair 对象和 SocketProtectionLevel 枚举的远程网络目标的异步操作。此方法不可从 JavaScript 中调用。

语法


public IAsyncAction ConnectAsync(
  EndpointPair endpointPair, 
  SocketProtectionLevel protectionLevel
)

参数

endpointPair

类型: EndpointPair

一个 EndpointPair 对象,指定本地主机名或 IP 地址、本地服务名称或 TCP 端口、远程主机名或远程 IP 地址以及远程网络目标的远程服务名称或远程 TCP 端口。

protectionLevel

类型: SocketProtectionLevel

表示 StreamSocket 对象的完整性和加密的保护级别。

返回值

类型: IAsyncAction

StreamSocket 对象的异步连接操作。

备注

如果在 endpointPair 参数中传递的 EndpointPair 对象包含针对 LocalHostName 属性的 null 值,则系统将提供要使用的本地 IP 地址。如果在 endpointPair 参数中传递的 EndpointPair 对象包含一个针对 LocalServiceName 属性的空字符串,则系统将提供要使用的本地 TCP 端口。

如果在 endpointPair 参数中传递的 EndpointPair 对象包含针对 LocalServiceName 属性的 null 值,则出现一个错误。

ConnectAsync(EndpointPair, SocketProtectionLevel) 方法未在 JavaScript 中公开。此方法不能从 JavaScript 中调用,因为它与 ConnectAsync(HostName, String) 方法有相同数量的参数。

以 JavaScript 编写的应用程序不能直接使用 SSL 来连接 StreamSocket,如果它使用 EndpointPair 的话。为了使用 SSL 连接 EndpointPair,JavaScript 应用程序可以改为使用以下代码。



var clientSocket = new Windows.Networking.Sockets.StreamSocket();
var remoteName = new Windows.Networking.HostName("www.contoso.com");
var myEndpointPair = EndpointPair();

// Set properties needed on the EndpointPair
// We only set remote properties and the localServiceName,
// But the localHostName could also be set

myEndpointPair.localServiceName = "12345";
myEndpointPair.remoteHostName = remoteName;
myEndpointPair.remoteServiceName = "http";

// First connect the socket without SSL
clientSocket.connectAsync(myEendpointPair>).then(function () {
    // Now upgrade the connection to SSL
    clientSocket.upgradeToSslAsync(SocketProtectionLevel.Ssl).then(function () {
        // now connected using SSL
    }
}   


要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8

命名空间

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

元数据

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

internetClientServer
privateNetworkClientServer
ID_CAP_NETWORKING [Windows Phone]

另请参见

StreamSocket
ConnectAsync(EndpointPair)
ConnectAsync(HostName, String)
ConnectAsync(HostName, String, SocketProtectionLevel)
EndpointPair

 

 

显示:
© 2015 Microsoft