정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

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 개체에 LocalHostName 속성에 대해 null이 포함될 경우 시스템은 사용되는 로컬 IP 주소를 제공합니다. endpointPair 매개 변수에 전달된 EndpointPair 개체에 LocalServiceName 속성에 대한 빈 문자열이 포함될 경우 시스템은 사용될 로컬 TCP 포트를 제공합니다.

endpointPair 매개 변수에 전달된 EndpointPair 개체에 LocalServiceName 속성에 대해 null이 포함될 경우 오류가 발생합니다.

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

Namespace

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

Metadata

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

 

 

표시: