StreamSocket.GetEndpointPairsAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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)
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
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
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)
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
Eine Liste von EndpointPair-Objekten .
- Attribute
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.