DatagramSocket.BindEndpointAsync(HostName, String) 메서드

정의

네임스페이스:

Windows.Networking.Sockets

DatagramSocket에서 로컬 호스트 이름 및 로컬 서비스 이름에 대한 바인딩 작업을 시작합니다.

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);

function bindEndpointAsync(localHostName, localServiceName)

Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

매개 변수

localHostName

HostName

DatagramSocket 개체를 바인딩할 로컬 호스트 이름 또는 IP 주소입니다.

localServiceName

String

Platform::String

winrt::hstring

DatagramSocket 개체를 바인딩할 로컬 서비스 이름 또는 UDP 포트입니다.

반환

IAsyncAction

DatagramSocket 개체에 대한 비동기 바인딩 작업입니다.

특성

RemoteAsyncAttribute

Windows 요구 사항

앱 기능	ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

설명

BindEndpointAsync 메서드는 DatagramSocket 을 localHostName 매개 변수에 지정된 로컬 호스트 이름 또는 IP 주소와 localServiceName 매개 변수에 지정된 로컬 서비스 이름 또는 UDP 포트 번호 주소에 바인딩합니다. localHostName 매개 변수가 null이면 시스템은 바인딩할 로컬 IP 주소를 선택합니다. localServiceName 매개 변수가 빈 문자열인 경우 시스템은 바인딩할 로컬 UDP 포트를 선택합니다.

DatagramSocketControl.MulticastOnly 속성을 사용하지 않는 한 UDP를 사용하는 다른 앱(예: 다른 DatagramSocket)이 localHostName 및 localServiceName 매개 변수에 지정된 UDP 포트와 로컬 IP 주소에 이미 바인딩된 경우 BindEndpointAsync 메서드가 실패합니다.

바인딩은 DatagramSocket의 모든 원격 엔드포인트에서 데이터를 수신하는 데 필수적이며 일반적으로 소켓이 만들어지고 MessageReceived 이벤트가 설정된 후에 수행됩니다. BindServiceNameAsync 또는 BindEndpointAsync 메서드는 DatagramSocket을 로컬 서비스 이름 또는 UDP 포트에 바인딩하는 데 사용됩니다. 또한 ConnectAsync 메서드는 소켓이 아직 바인딩되지 않은 경우 바인딩 작업을 수행합니다. GetOutputStreamAsync 메서드 중 하나에서 반환된 스트림에 쓰면 바인딩 작업도 발생합니다.

BindServiceNameAsync 및 BindEndpointAsync 메서드는 다음 경우에 필요하지 않습니다.

• DatagramSocket은 데이터를 보내는 데만 사용됩니다.
• DatagramSocket은 단일 엔드포인트로 데이터를 보내고 받는 데 사용됩니다.

추가 정보

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived