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
| Name | Beschreibung |
|---|---|
| GetEndpointPairsAsync(HostName, String) |
Ruft eine Liste der EndpointPair Objekte basierend auf einem Remotehost- und Remotedienstnamen ab, die zum Senden von TCP-Paketen an ein Remotenetzwerkziel verwendet werden können. |
| GetEndpointPairsAsync(HostName, String, HostNameSortOptions) |
Ruft eine Liste der EndpointPair- -Objekte basierend auf einem Remotehost- und Remotedienstnamen und der zu verwendenden Sortierreihenfolge ab. |
GetEndpointPairsAsync(HostName, String)
Ruft eine Liste der EndpointPair Objekte basierend auf einem Remotehost- und Remotedienstnamen ab, 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 in mehreren Diensten gehostet werden, sodass eine DNS-Suche mehrere IP-Adressen für die verschiedenen Server zurückgibt. Diese Methode gibt ein Endpunktpaar für jeden der Server zurück, die von einer DNS-Suche gefunden wurden.
- remoteServiceName
-
String
Platform::String
winrt::hstring
Der Name oder die Portnummer eines Remotediensts. Beachten Sie, dass unterschiedliche Server möglicherweise den benannten Dienst an verschiedenen physischen Ports unterstützen, sodass nicht alle zurückgegebenen Endpunkte dieselbe Dienstportnummer verwenden.
Gibt zurück
Ein asynchroner Nachschlagevorgang. Nach erfolgreichem Abschluss enthält die zurückgegebene Liste eine EndpointPair- für jeden gefundenen Remotehost, wobei ein Endpunkt einer der Remotehosts und der andere der lokale Host ist.
- Attribute
Windows-Anforderungen
| Anforderungen | Beschreibung |
|---|---|
| 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- zum Senden von Daten an ein Remotenetzwerkziel mithilfe von TCP verwendet werden können. Die zurückgegebene Liste wird sortiert, sodass die Adresspaare, die am besten für die Kommunikation zwischen zwei Peers geeignet sind, weiter oben in der Liste auftreten.
Ein StreamSocket- kann die von dieser Methode zurückgegebene Liste verwenden, um jedes EndpointPair--Objekt zu binden oder eine Verbindung herzustellen, bis eine Verbindung hergestellt werden kann. Ein EndpointPair--Objekt aus der Liste würde mit den methoden ConnectAsync(EndpointPair) verwendet.
Siehe auch
Gilt für:
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)
Ruft eine Liste der EndpointPair- -Objekte basierend auf einem Remotehost- und Remotedienstnamen und der zu verwendenden Sortierreihenfolge ab.
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 Name des Remotediensts oder der UDP-Port.
- sortOptions
- HostNameSortOptions
Die Sortierreihenfolge, die beim Zurückgeben der Liste verwendet werden soll.
Gibt zurück
Eine Liste der EndpointPair--Objekte.
- Attribute
Windows-Anforderungen
| Anforderungen | Beschreibung |
|---|---|
| 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 jedes EndpointPair--Objekt zu binden oder eine Verbindung herzustellen, bis ein Remoteziel erreicht werden kann. Ein EndpointPair--Objekt aus der Liste würde mit der ConnectAsync(EndpointPair)--Methode verwendet.