EndpointPair(HostName, String, HostName, String) 생성자

정의

네임스페이스:

Windows.Networking

새 EndpointPair 개체를 만듭니다.

public:
 EndpointPair(HostName ^ localHostName, Platform::String ^ localServiceName, HostName ^ remoteHostName, Platform::String ^ remoteServiceName);

 EndpointPair(HostName const& localHostName, winrt::hstring const& localServiceName, HostName const& remoteHostName, winrt::hstring const& remoteServiceName);

public EndpointPair(HostName localHostName, string localServiceName, HostName remoteHostName, string remoteServiceName);

function EndpointPair(localHostName, localServiceName, remoteHostName, remoteServiceName)

Public Sub New (localHostName As HostName, localServiceName As String, remoteHostName As HostName, remoteServiceName As String)

매개 변수

localHostName

HostName

EndpointPair 개체의 로컬 호스트 이름 또는 IP 주소입니다.

localServiceName

String

Platform::String

winrt::hstring

EndpointPair 개체의 로컬 서비스 이름 또는 로컬 TCP 또는 UDP 포트 번호입니다.

remoteHostName

HostName

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

remoteServiceName

String

Platform::String

winrt::hstring

EndpointPair 개체의 원격 서비스 이름 또는 원격 TCP 또는 UDP 포트 번호입니다.

설명

이 생성자는 로컬 호스트 이름, 로컬 서비스 이름, 원격 호스트 이름 및 원격 서비스 이름에서 새 EndpointPair 개체를 만듭니다. EndpointPair 개체는 네트워크 연결에 대한 로컬 엔드포인트 및 원격 엔드포인트에 대한 네트워크 앱에서 사용하는 데이터를 제공합니다.

엔드포인트는 다음 두 가지 구성 요소로 구성됩니다.

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

• 서비스 이름 또는 TCP 또는 UDP 포트 번호입니다. 엔드포인트 쌍은 다음 두 구성 요소로 구성됩니다.

• 네트워크 연결에 대한 로컬 엔드포인트입니다.

• 네트워크 연결에 대한 원격 엔드포인트입니다. localHostName 매개 변수는 다음 중 하나를 포함할 수 있습니다.

• DNS(Domain Name System) 또는 다른 네임스페이스 공급자가 확인할 수 있는 로컬 호스트의 이름입니다.

• 로컬 컴퓨터의 다음 파일에서 문자열과 일치하는 로컬 호스트의 이름: %WINDIR%\system32\drivers\etc\hosts

• 로컬 호스트의 IPv4 또는 IPv6 네트워크 주소를 포함하는 문자열입니다. IPv4 주소 문자열은 점 10진수 표기법(예: "192.168.1.111")에 있습니다. IPv6 주소는 16진수 표기법입니다(예: "21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A"). localHostName 매개 변수가 "localhost" 문자열인 경우 로컬 컴퓨터의 모든 루프백 주소를 나타냅니다.

Windows.Networking.Connectivity 네임스페이스의 NetworkInformation.GetHostNames 메서드를 사용하여 로컬 컴퓨터와 연결된 호스트 이름 또는 IP 주소 목록을 검색할 수 있습니다. 그런 다음 localHostName 매개 변수에 이러한 호스트 이름 또는 IP 주소 중 하나를 사용할 수 있습니다.

localHostName 매개 변수를 null로 설정할 수도 있습니다. 클라이언트 앱에서 네트워크 연결을 설정하기 전에 localHostName 이 null이면 시스템에서 사용할 앱의 로컬 IP 주소를 자동으로 제공합니다.

localServiceName 매개 변수는 다음 중 하나를 포함할 수 있습니다.

• TCP 또는 UDP 포트 번호에 대한 숫자 리터럴입니다(예: http에 사용되는 TCP 포트의 경우 80).
• 로컬 컴퓨터의 다음 파일에 있는 문자열과 일치하는 포트 번호(예: "http")의 문자열 별칭입니다. %WINDIR%\system32\drivers\etc\services
• SRV 레코드를 사용하여 네임스페이스 공급자가 확인할 수 있는 서비스 이름입니다. localServiceName 매개 변수에는 빈 문자열도 포함될 수 있습니다. 네트워크 연결이 설정되기 전에 로컬 서비스 이름이 로컬 엔드포인트에 대한 빈 문자열인 경우 시스템은 네트워크 연결을 설정할 때 사용할 앱에 대한 TCP 또는 UDP IP 포트 번호를 자동으로 제공합니다.

localServiceName 매개 변수가 null이면 생성자가 실패합니다.

remoteHostName 매개 변수는 다음 중 하나를 포함할 수 있습니다.

• DNS(Domain Name System) 또는 다른 네임스페이스 공급자가 확인할 수 있는 원격 호스트의 이름입니다.
• 로컬 컴퓨터의 다음 파일에서 문자열과 일치하는 호스트의 이름: %WINDIR%\system32\drivers\etc\hosts
• 원격 호스트의 IPv4 또는 IPv6 네트워크 주소를 포함하는 문자열입니다. IPv4 주소 문자열은 점 10진수 표기법(예: "192.168.1.111")에 있습니다. IPv6 주소는 16진수 표기법입니다(예: "21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A"). remoteHostName 매개 변수가 "localhost" 문자열인 경우 로컬 컴퓨터의 모든 루프백 주소를 나타냅니다.

remoteHostName 매개 변수가 null이거나 빈 문자열을 포함하는 경우 생성자가 실패합니다.

remoteServiceName 매개 변수는 다음 중 하나를 포함할 수 있습니다.

• TCP 또는 UDP 포트 번호에 대한 숫자 리터럴입니다(예: http에 사용되는 TCP 포트의 경우 80).
• 로컬 컴퓨터의 다음 파일에 있는 문자열과 일치하는 포트 번호(예: "http")의 문자열 별칭입니다. %WINDIR%\system32\drivers\etc\services
• SRV 레코드를 사용하여 네임스페이스 공급자가 확인할 수 있는 서비스 이름입니다. remoteServiceName 매개 변수가 null이거나 빈 문자열을 포함하는 경우 생성자가 실패합니다.

추가 정보

• Windows.Networking