StreamSocket.GetEndpointPairsAsync 메서드

  • 참조

정의

네임스페이스:
Windows.Networking.Sockets

오버로드

GetEndpointPairsAsync(HostName, String)

원격 네트워크 대상으로 TCP 패킷을 보내는 데 사용할 수 있는 원격 호스트 이름 및 원격 서비스 이름을 기반으로 하는 EndpointPair 개체 목록을 가져옵니다.
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

원격 호스트 이름 및 원격 서비스 이름 및 사용할 정렬 순서를 기반으로 하는 EndpointPair 개체 목록을 가져옵니다.

GetEndpointPairsAsync(HostName, String)

편집

원격 네트워크 대상으로 TCP 패킷을 보내는 데 사용할 수 있는 원격 호스트 이름 및 원격 서비스 이름을 기반으로 하는 EndpointPair 개체 목록을 가져옵니다.

public:
 static IAsyncOperation<IVectorView<EndpointPair ^> ^> ^ GetEndpointPairsAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName);
/// [Windows.Foundation.Metadata.Overload("GetEndpointPairsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<EndpointPair>> GetEndpointPairsAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName);
[Windows.Foundation.Metadata.Overload("GetEndpointPairsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<EndpointPair>> GetEndpointPairsAsync(HostName remoteHostName, string remoteServiceName);
function getEndpointPairsAsync(remoteHostName, remoteServiceName)
Public Shared Function GetEndpointPairsAsync (remoteHostName As HostName, remoteServiceName As String) As IAsyncOperation(Of IReadOnlyList(Of EndpointPair))

매개 변수

remoteHostName
HostName

서비스의 호스트 이름입니다. DNS 조회가 다양한 서버에 대해 여러 IP 주소를 반환할 수 있도록 서비스가 실제로 여러 서비스에서 호스트될 수 있습니다. 이 메서드는 DNS 조회에서 찾은 각 서버에 대해 하나의 엔드포인트 쌍을 반환합니다.

remoteServiceName
String

Platform::String

winrt::hstring

원격 서비스의 이름 또는 포트 번호입니다. 다른 서버는 서로 다른 물리적 포트에서 명명된 서비스를 지원할 수 있으므로 반환된 모든 엔드포인트에서 동일한 서비스 포트 번호를 사용하지는 않습니다.

반환

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

비동기 조회 작업입니다. 성공적으로 완료되면 반환된 목록에는 찾은 각 원격 호스트에 대해 하나의 EndpointPair 가 포함되며, 한 엔드포인트는 원격 호스트 중 하나이고 다른 하나는 로컬 호스트입니다.

특성
OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

디바이스 패밀리
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

이 메서드는 StreamSocket에서 TCP를 사용하여 원격 네트워크 대상으로 데이터를 보내는 데 사용할 수 있는 가능한 EndpointPair 개체 목록을 가져옵니다. 반환된 목록은 두 피어 간의 통신에 가장 적합한 주소 쌍이 목록의 앞부분에서 발생되도록 정렬됩니다.

StreamSocket은 이 메서드에서 반환된 목록을 사용하여 연결이 이루어질 때까지 각 EndpointPair 개체를 시도하고 바인딩하거나 연결할 수 있습니다. 목록의 EndpointPair 개체는 ConnectAsync(EndpointPair) 메서드와 함께 사용됩니다.

추가 정보

적용 대상

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

편집

원격 호스트 이름 및 원격 서비스 이름 및 사용할 정렬 순서를 기반으로 하는 EndpointPair 개체 목록을 가져옵니다.

public:
 static IAsyncOperation<IVectorView<EndpointPair ^> ^> ^ GetEndpointPairsAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName, HostNameSortOptions sortOptions);
/// [Windows.Foundation.Metadata.Overload("GetEndpointPairsWithSortOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<EndpointPair>> GetEndpointPairsAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName, HostNameSortOptions const& sortOptions);
[Windows.Foundation.Metadata.Overload("GetEndpointPairsWithSortOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<EndpointPair>> GetEndpointPairsAsync(HostName remoteHostName, string remoteServiceName, HostNameSortOptions sortOptions);
function getEndpointPairsAsync(remoteHostName, remoteServiceName, sortOptions)
Public Shared Function GetEndpointPairsAsync (remoteHostName As HostName, remoteServiceName As String, sortOptions As HostNameSortOptions) As IAsyncOperation(Of IReadOnlyList(Of EndpointPair))

매개 변수

remoteHostName
HostName

원격 호스트 이름 또는 IP 주소입니다.

remoteServiceName
String

Platform::String

winrt::hstring

원격 서비스 이름 또는 UDP 포트입니다.

sortOptions
HostNameSortOptions

목록을 반환할 때 사용할 정렬 순서입니다.

반환

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

EndpointPair 개체 목록입니다.

특성
OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

디바이스 패밀리
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

GetEndpointPairsAsync 메서드는 StreamSocket에서 원격 네트워크 대상에 연결하는 데 사용할 수 있는 가능한 EndpointPair 개체 목록을 가져옵니다. 반환된 목록은 sortOptions 매개 변수에 따라 정렬됩니다.

StreamSocket은 이 메서드에서 반환된 목록을 사용하여 원격 대상에 도달할 때까지 각 EndpointPair 개체를 시도하고 바인딩하거나 연결할 수 있습니다. 목록의 EndpointPair 개체는 ConnectAsync(EndpointPair) 메서드와 함께 사용됩니다.

추가 정보

적용 대상