내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StreamSocketListener Class

TCP 스트림 소켓 또는 Bluetooth RFCOMM을 사용한 들어오는 네트워크 연결 수신을 지원합니다.

구문


var streamSocketListener = new Windows.Networking.Sockets.StreamSocketListener();

특성

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

멤버

StreamSocketListener클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

StreamSocketListener클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
StreamSocketListener Creates a new StreamSocketListener object.

 

이벤트

StreamSocketListener클래스에는 다음과 같은 이벤트가 있습니다.

이벤트Description
ConnectionReceived An event that indicates that a connection was received on the StreamSocketListener object.

 

메서드

The StreamSocketListener 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
BindEndpointAsync Starts a bind operation on a StreamSocketListener to a local hostname and a local service name.
BindServiceNameAsync(String) Starts a bind operation on a StreamSocketListener to a local service name.
BindServiceNameAsync(String, SocketProtectionLevel) Starts a bind operation on a StreamSocketListener to a local service name with a specified SocketProtectionLevel to set on any bound sockets.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) Starts a socket bind operation on a StreamSocketListener to a local service name on a specified network adapter with a specified SocketProtectionLevel to set on any bound sockets.
Close [C++, JavaScript]Closes the StreamSocketListener object.
Dispose [C#, VB]Performs tasks associated with freeing, releasing, or resetting unmanaged resources.

 

속성

StreamSocketListener클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

Control

읽기 전용Gets socket control data on a StreamSocketListener object.

Information

읽기 전용Gets socket information for the StreamSocketListener object.

 

설명

StreamSocketListener 클래스는 TCP 스트림 소켓을 사용하고 연결을 허용하는 들어오는 네트워크 연결에 대한 수신 대기를 지원합니다.

일반적인 작업 순서는 다음과 같습니다.

  • StreamSocketListener를 만듭니다.
  • Control 속성을 사용하여 StreamSocketListenerControl 개체를 검색하고 필요한 서비스의 소켓 품질을 설정합니다.
  • ConnectionReceived 이벤트를 이벤트 처리기에 할당합니다.
  • BindServiceNameAsync 또는 BindEndpointAsync 메서드를 호출하여 로컬 TCP 포트 또는 서비스 이름에 바인딩합니다.
  • 연결을 받을 때 StreamSocketListenerConnectionReceivedEventArgs 개체를 사용하여 StreamSocket 개체를 만든 Socket 속성을 검색합니다.
  • StreamSocket 개체를 사용하여 데이터를 보내고 받습니다.
  • Close 메서드를 호출하여 들어오는 네트워크 연결을 수신 및 허용하고 StreamSocketListener 개체와 관련된 관리되지 않은 모든 리소스를 해제합니다. 연결이 수신될 때 생성된 StreamSocket 개체는 아무 영향을 받지 않고 필요에 따라 계속 사용할 수 있습니다.

예외 처리

StreamSocketListener 클래스에서 비동기 메서드를 호출할 때 예외를 처리하는 코드를 작성해야 합니다. 매개 변수 유효성 검사 오류, 이름 확인 실패 및 네트워크 오류에서 예외가 발생할 수 있습니다. 언제든지 네트워크 오류(예: 연결 끊어짐, 연결 실패, 서버 실패)의 예외가 발생할 수 있습니다. 이러한 오류가 발생하면 예외가 throw됩니다. 앱에서 예외를 처리하지 않을 경우 런타임에 의해 전체 앱이 종료될 수 있습니다.

Windows.Networking.Sockets 네임스페이스에는 소켓을 사용할 때 오류 처리에 편리한 도우미 메서드 및 열거형이 있습니다. 앱에서 특정 네트워크 예외를 다르게 처리할 때 유용할 수 있습니다. 앱은 매개 변수 유효성 검사 오류에 대한 예외의 HRESULT를 사용하여 예외를 발생시키는 오류에 대한 자세한 정보를 볼 수 있습니다.

가능한 예외 및 예외 처리 방법에 대한 자세한 내용은 네트워크 앱의 예외 처리를 참조하십시오.

Windows Server 2012에서 StreamSocketListener 사용

Windows Server 2012 및 Windows Server 2012 R2에서 미디어 파운데이션 기능을 사용하도록 설정되지 않은 경우 Windows.Networking.Sockets 네임스페이스에서 클래스의 대부분을 구현하는 Windows.Networking.dll을 로드하지 못합니다. 결과적으로 Media Foundation 기능을 사용하지 않도록 설정하면 Windows.Networking.Sockets 네임스페이스에 있는 StreamSocketListener 및 관련 소켓 클래스를 사용하는 앱은 실패합니다. Windows Server 2012 또는 Windows Server 2012 R2를 설치하면 기본적으로 미디어 파운데이션 기능이 해제되어 있습니다.

서버 관리자를 사용하거나 명령 프롬프트나 스크립트에 다음 텍스트를 입력하여 Windows Server 2012 또는 Windows Server 2012 R2에서 Media Foundation 기능을 활성화할 수 있습니다.

dism /online /enable-feature /featurename:ServerMediaFoundation

Media Foundation 기능을 사용하도록 설정한 후 다시 부팅할 것인지 묻는 메시지가 표시됩니다. 컴퓨터를 다시 시작하면 Windows.Networking.Sockets 네임스페이스의 WebSocket 및 소켓용 클래스는 예상대로 작동합니다.

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱, 데스크톱 앱]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱, 데스크톱 앱]

지원되는 최소 전화

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]

참고 항목

기타 리소스
네트워크 서비스에 연결(JavaScript 및 HTML을 사용하는 Windows 스토어 앱)
네트워크 서비스에 연결(C#/VB/C++ 및 XAML을 사용하는 Windows 스토어 앱)
네트워크 앱에서 예외 처리
고급 소켓 컨트롤을 사용하는 방법(JavaScript 및 HTML을 사용하는 Windows 스토어 앱)
고급 소켓 컨트롤을 사용하는 방법(C#/VB/C++ 및 XAML을 사용하는 Windows 스토어 앱)
빠른 시작: 스트림 소켓(JavaScript 및 HTML을 사용하는 Windows 스토어 앱)을 사용하여 네트워크 리소스에 연결
네트워크 연결 문제 해결 및 디버깅
참조
IClosable
Object
StreamSocket
StreamSocketListenerConnectionReceivedEventArgs
StreamSocketListenerControl
StreamSocketListenerInformation

 

 

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft