StreamSocket.GetEndpointPairsAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Networking.Sockets

Overload

GetEndpointPairsAsync(HostName, String)

Mendapatkan daftar objek EndpointPair berdasarkan nama host jarak jauh dan nama layanan jarak jauh yang dapat digunakan untuk mengirim paket TCP ke tujuan jaringan jarak jauh.
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Mendapatkan daftar objek EndpointPair berdasarkan nama host jarak jauh dan nama layanan jarak jauh dan urutan pengurutan yang akan digunakan.

GetEndpointPairsAsync(HostName, String)

Edit

Mendapatkan daftar objek EndpointPair berdasarkan nama host jarak jauh dan nama layanan jarak jauh yang dapat digunakan untuk mengirim paket TCP ke tujuan jaringan jarak jauh.

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))

Parameter

remoteHostName
HostName

Nama host layanan. Layanan ini mungkin benar-benar dihosting di beberapa layanan, sehingga pencarian DNS mengembalikan beberapa alamat IP untuk berbagai server. Metode ini mengembalikan satu pasangan titik akhir untuk setiap server yang ditemukan oleh pencarian DNS.

remoteServiceName
String

Platform::String

winrt::hstring

Nama atau nomor port layanan jarak jauh. Perhatikan bahwa server yang berbeda mungkin mendukung layanan bernama pada port fisik yang berbeda, sehingga tidak semua titik akhir yang dikembalikan akan menggunakan nomor port layanan yang sama.

Mengembalikan

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Operasi pencarian asinkron. Setelah berhasil diselesaikan, daftar yang dikembalikan berisi satu EndpointPair untuk setiap host jarak jauh yang ditemukan, dengan satu titik akhir menjadi salah satu host jarak jauh dan yang lainnya adalah host lokal.

Atribut
OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Metode ini mendapatkan daftar kemungkinan objek EndpointPair yang dapat digunakan oleh StreamSocket untuk mengirim data ke tujuan jaringan jarak jauh menggunakan TCP. Daftar yang dikembalikan diurutkan sehingga pasangan alamat yang paling cocok untuk komunikasi antara dua rekan terjadi sebelumnya dalam daftar.

StreamSocket dapat menggunakan daftar yang dikembalikan oleh metode ini untuk mencoba dan mengikat atau menyambungkan ke setiap objek EndpointPair hingga koneksi dapat dibuat. Objek EndpointPair dari daftar akan digunakan dengan metode ConnectAsync(EndpointPair)

Lihat juga

Berlaku untuk

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Edit

Mendapatkan daftar objek EndpointPair berdasarkan nama host jarak jauh dan nama layanan jarak jauh dan urutan pengurutan yang akan digunakan.

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))

Parameter

remoteHostName
HostName

Nama host jarak jauh atau alamat IP.

remoteServiceName
String

Platform::String

winrt::hstring

Nama layanan jarak jauh atau port UDP.

sortOptions
HostNameSortOptions

Urutan pengurutan yang akan digunakan saat mengembalikan daftar.

Mengembalikan

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Daftar objek EndpointPair .

Atribut
OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Metode GetEndpointPairsAsync mendapatkan daftar kemungkinan objek EndpointPair yang dapat digunakan oleh StreamSocket untuk terhubung ke tujuan jaringan jarak jauh. Daftar yang dikembalikan diurutkan berdasarkan parameter sortOptions .

StreamSocket dapat menggunakan daftar yang dikembalikan oleh metode ini untuk mencoba dan mengikat atau menyambungkan ke setiap objek EndpointPair hingga tujuan jarak jauh dapat dicapai. Objek EndpointPair dari daftar akan digunakan dengan metode ConnectAsync(EndpointPair).

Lihat juga

Berlaku untuk