Freigeben über

StreamSocket.GetEndpointPairsAsync Methode

  • Referenz

Definition

Namespace:
Windows.Networking.Sockets

Überlädt

GetEndpointPairsAsync(HostName, String)

Ruft eine Liste von EndpointPair-Objekten ab, die auf einem Remotehosthost und einem Remotedienstnamen basieren, die zum Senden von TCP-Paketen an ein Remotenetzwerkziel verwendet werden können.
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Ruft eine Liste von EndpointPair-Objekten ab, die auf einem Remotehosthost und Remotedienstnamen und der zu verwendenden Sortierreihenfolge basieren.

GetEndpointPairsAsync(HostName, String)

Bearbeiten

Ruft eine Liste von EndpointPair-Objekten ab, die auf einem Remotehosthost und einem Remotedienstnamen basieren, die zum Senden von TCP-Paketen an ein Remotenetzwerkziel verwendet werden können.

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

Der Hostname eines Diensts. Der Dienst kann tatsächlich auf mehreren Diensten gehostet werden, sodass ein DNS-Lookup mehrere IP-Adressen für die verschiedenen Server zurückgibt. Diese Methode gibt ein Endpunktpaar für jeden server zurück, der von einer DNS-Suche gefunden wurde.

remoteServiceName
String

Platform::String

winrt::hstring

Der Name oder die Portnummer eines Remotediensts. Beachten Sie, dass verschiedene Server den benannten Dienst möglicherweise an verschiedenen physischen Ports unterstützen, sodass nicht alle zurückgegebenen Endpunkte dieselbe Dienstportnummer verwenden.

Gibt zurück

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Ein asynchroner Suchvorgang. Nach erfolgreichem Abschluss enthält die zurückgegebene Liste einen EndpointPair für jeden gefundenen Remotehost, wobei ein Endpunkt einer der Remotehosts und der andere der lokale Host ist.

Attribute
OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Diese Methode ruft eine Liste möglicher EndpointPair-Objekte ab, die von einem StreamSocket verwendet werden können, um Daten mithilfe von TCP an ein Remotenetzwerkziel zu senden. Die zurückgegebene Liste ist so sortiert, dass die Adresspaare, die sich am besten für die Kommunikation zwischen zwei Peers eignen, früher in der Liste auftreten.

Ein StreamSocket kann die von dieser Methode zurückgegebene Liste verwenden, um zu versuchen, jedes EndpointPair-Objekt zu binden oder eine Verbindung mit diesen herzustellen, bis eine Verbindung hergestellt werden kann. Ein EndpointPair-Objekt aus der Liste wird mit den Methoden ConnectAsync(EndpointPair) verwendet.

Weitere Informationen

Gilt für:

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Bearbeiten

Ruft eine Liste von EndpointPair-Objekten ab, die auf einem Remotehosthost und Remotedienstnamen und der zu verwendenden Sortierreihenfolge basieren.

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

Der Remotehostname oder die IP-Adresse.

remoteServiceName
String

Platform::String

winrt::hstring

Der Remotedienstname oder DER UDP-Port.

sortOptions
HostNameSortOptions

Die Sortierreihenfolge, die beim Zurückgeben der Liste verwendet werden soll.

Gibt zurück

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Eine Liste von EndpointPair-Objekten .

Attribute
OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Die GetEndpointPairsAsync-Methode ruft eine Liste möglicher EndpointPair-Objekte ab, die von einem StreamSocket zum Herstellen einer Verbindung mit einem Remotenetzwerkziel verwendet werden können. Die zurückgegebene Liste wird basierend auf dem sortOptions-Parameter sortiert.

Ein StreamSocket kann die von dieser Methode zurückgegebene Liste verwenden, um zu versuchen, jedes EndpointPair-Objekt zu binden oder eine Verbindung mit diesem herzustellen, bis ein Remoteziel erreicht werden kann. Ein EndpointPair-Objekt aus der Liste wird mit der ConnectAsync(EndpointPair)- Methode verwendet.

Weitere Informationen

Gilt für: