EndpointPair(HostName, String, HostName, String) Konstruktor

Definisi

Ruang nama:

Windows.Networking

Membuat objek EndpointPair baru.

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)

Parameter

localHostName

HostName

Nama host lokal atau alamat IP untuk objek EndpointPair .

localServiceName

String

Platform::String

winrt::hstring

Nama layanan lokal atau nomor port TCP atau UDP lokal untuk objek EndpointPair .

remoteHostName

HostName

Nama host jarak jauh atau alamat IP untuk objek EndpointPair .

remoteServiceName

String

Platform::String

winrt::hstring

Nama layanan jarak jauh atau nomor port TCP atau UDP jarak jauh untuk objek EndpointPair .

Keterangan

Konstruktor ini membuat objek EndpointPair baru dari nama host lokal, nama layanan lokal, nama host jarak jauh, dan nama layanan jarak jauh. Objek EndpointPair menyediakan data yang digunakan oleh aplikasi jaringan untuk titik akhir lokal dan titik akhir jarak jauh untuk koneksi jaringan.

Titik akhir terdiri dari dua komponen:

• Nama host atau alamat IP.

• Nama layanan atau nomor port TCP atau UDP. Pasangan titik akhir terdiri dari dua komponen:

• Titik akhir lokal untuk koneksi jaringan.

• Titik akhir jarak jauh untuk koneksi jaringan. Parameter localHostName dapat berisi salah satu hal berikut ini:

• Nama host lokal yang dapat diselesaikan oleh Sistem Nama Domain (DNS) atau oleh penyedia namespace layanan lain.

• Nama host lokal yang cocok dengan string dalam file berikut di komputer lokal: %WINDIR%\system32\drivers\etc\hosts

• String yang berisi alamat jaringan IPv4 atau IPv6 dari host lokal. String alamat IPv4 berada dalam notasi desimal putus-putus ("192.168.1.111", misalnya). Alamat IPv6 berada dalam notasi heksadesimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", misalnya). Jika parameter localHostName adalah string "localhost", ini mewakili semua alamat loopback di komputer lokal.

Metode NetworkInformation.GetHostNames di namespace Layanan Windows.Networking.Connectivity dapat digunakan untuk mengambil daftar nama host atau alamat IP yang terkait dengan komputer lokal. Salah satu nama host atau alamat IP ini kemudian dapat digunakan untuk parameter localHostName .

Parameter localHostName juga dapat diatur ke null. Jika localHostName null sebelum koneksi jaringan dibuat oleh aplikasi klien, maka sistem akan secara otomatis menyediakan alamat IP lokal untuk digunakan aplikasi.

Parameter localServiceName dapat berisi salah satu hal berikut ini:

• Literal numerik untuk nomor port TCP atau UDP (80 untuk port TCP yang digunakan untuk http, misalnya).
• Alias string untuk nomor port ("http", misalnya) yang cocok dengan string dalam file berikut di komputer lokal: %WINDIR%\system32\drivers\etc\services
• Nama layanan yang dapat diselesaikan oleh penyedia namespace menggunakan catatan SRV. Parameter localServiceName juga dapat berisi string kosong. Jika nama layanan lokal adalah string kosong untuk titik akhir lokal sebelum koneksi jaringan dibuat, maka sistem akan secara otomatis menyediakan nomor port IP TCP atau UDP untuk digunakan aplikasi saat membuat koneksi jaringan.

Konstruktor akan gagal jika parameter localServiceName null.

Parameter remoteHostName dapat berisi salah satu hal berikut:

• Nama host jarak jauh yang dapat diselesaikan oleh Sistem Nama Domain (DNS) atau oleh penyedia namespace layanan lain.
• Nama host yang cocok dengan string dalam file berikut di komputer lokal: %WINDIR%\system32\drivers\etc\hosts
• String yang berisi alamat jaringan IPv4 atau IPv6 dari host jarak jauh. String alamat IPv4 berada dalam notasi desimal putus-putus ("192.168.1.111", misalnya). Alamat IPv6 berada dalam notasi heksadesimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", misalnya). Jika parameter remoteHostName adalah string "localhost", ini mewakili semua alamat loopback di komputer lokal.

Konstruktor akan gagal jika parameter remoteHostName null atau berisi string kosong.

Parameter remoteServiceName dapat berisi salah satu hal berikut:

• Literal numerik untuk nomor port TCP atau UDP (80 untuk port TCP yang digunakan untuk http, misalnya).
• Alias string untuk nomor port ("http", misalnya) yang cocok dengan string dalam file berikut di komputer lokal: %WINDIR%\system32\drivers\etc\services
• Nama layanan yang dapat diselesaikan oleh penyedia namespace menggunakan catatan SRV. Konstruktor akan gagal jika parameter remoteServiceName null atau berisi string kosong.

Lihat juga

• Windows.Networking