情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StreamSocket.ConnectAsync(EndpointPair, SocketProtectionLevel) Method

StreamSocket オブジェクトで、EndpointPair オブジェクトと SocketProtectionLevel 列挙体として指定されているリモート ネットワーク送信先に接続する非同期操作を開始します。このメソッドは、JavaScript から呼び出すことはできません。

構文


public IAsyncAction ConnectAsync(
  EndpointPair endpointPair, 
  SocketProtectionLevel protectionLevel
)

パラメーター

endpointPair

型: EndpointPair

ローカル ホスト名または IP アドレス、ローカル サービス名または TCP ポート、リモート ホスト名またはリモート IP アドレス、リモート ネットワーク宛先のリモート サービス名またはリモート TCP ポートを指定する EndpointPair オブジェクト。

protectionLevel

型: SocketProtectionLevel

StreamSocket オブジェクトの整合性と暗号化を表す保護レベル。

戻り値

型: IAsyncAction

StreamSocket のオブジェクトの非同期接続操作です。

解説

endpointPair パラメーターに渡された EndpointPair オブジェクトに null の LocalHostName プロパティが含まれる場合、システムによって使用するローカル IP アドレスが指定されます。endpointPair パラメーターで渡された EndpointPair のオブジェクトが LocalServiceName プロパティ用の空の文字列を含んでいる場合、システムは使用するローカル TCP ポートを指定します。

endpointPair パラメーターに渡された EndpointPair オブジェクトに null の LocalServiceName プロパティが含まれる場合、エラーが発生します。

ConnectAsync(EndpointPair, SocketProtectionLevel) メソッドは JavaScript では公開されていません。このメソッドには、ConnectAsync(HostName, String) メソッドと同じ数の引数があるため、JavaScript から呼び出すことはできません。

JavaScript で記述されたアプリケーションは、SSL を直接使用して EndpointPair を使用する StreamSocket に接続できません。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

 

 

表示: