Freigeben über

EndpointPair(HostName, String, HostName, String) Konstruktor

  • Referenz

Definition

Namespace:
Windows.Networking
Bearbeiten

Erstellt ein neues EndpointPair-Objekt .

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

Der lokale Hostname oder die IP-Adresse für das EndpointPair-Objekt .

localServiceName
String

Platform::String

winrt::hstring

Der lokale Dienstname oder die lokale TCP- oder UDP-Portnummer für das EndpointPair-Objekt .

remoteHostName
HostName

Der Remotehostname oder die IP-Adresse für das EndpointPair-Objekt .

remoteServiceName
String

Platform::String

winrt::hstring

Der Remotedienstname oder die TCP- oder UDP-Remoteportnummer für das EndpointPair-Objekt .

Hinweise

Dieser Konstruktor erstellt ein neues EndpointPair-Objekt aus einem lokalen Hostnamen, einem lokalen Dienstnamen, einem Remotehostnamen und einem Remotedienstnamen. Das EndpointPair-Objekt stellt Daten bereit, die von Netzwerk-Apps für den lokalen Endpunkt und Remoteendpunkt für eine Netzwerkverbindung verwendet werden.

Ein Endpunkt besteht aus zwei Komponenten:

  • Der Hostname oder die IP-Adresse.

  • Der Dienstname oder die TCP- oder UDP-Portnummer. Ein Endpunktpaar besteht aus zwei Komponenten:

  • Der lokale Endpunkt für eine Netzwerkverbindung.

  • Der Remoteendpunkt für eine Netzwerkverbindung. Der parameter localHostName kann eine der folgenden Elemente enthalten:

  • Der Name des lokalen Hosts, der vom Domain Name System (DNS) oder einem anderen Namespaceanbieter aufgelöst werden kann.

  • Der Name des lokalen Hosts, der einer Zeichenfolge in der folgenden Datei auf dem lokalen Computer entspricht: %WINDIR%\system32\drivers\etc\hosts

  • Eine Zeichenfolge, die eine IPv4- oder eine IPv6-Netzwerkadresse des lokalen Hosts enthält. Eine IPv4-Adresszeichenfolge ist in gepunkteter Dezimalschreibweise ("192.168.1.111", z. B. 192.168.1.111). Eine IPv6-Adresse befindet sich in hexadezimaler Notation ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", z. B. 21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A). Wenn der parameter localHostName die Zeichenfolge "localhost" ist, stellt dies alle Loopbackadressen auf dem lokalen Computer dar.

Die NetworkInformation.GetHostNames-Methode im Windows.Networking.Connectivity-Namespace kann verwendet werden, um eine Liste von Hostnamen oder IP-Adressen abzurufen, die dem lokalen Computer zugeordnet sind. Eine dieser Hostnamen oder IP-Adressen kann dann für den parameter localHostName verwendet werden.

Der parameter localHostName kann auch auf NULL festgelegt werden. Wenn localHostName null ist, bevor eine Netzwerkverbindung durch eine Client-App hergestellt wird, stellt das System automatisch die lokale IP-Adresse für die zu verwendende App bereit.

Der parameter localServiceName kann eine der folgenden Elemente enthalten:

  • Ein numerisches Literal für eine TCP- oder UDP-Portnummer (z. B. 80 für den TCP-Port, der für http verwendet wird).
  • Ein Zeichenfolgenalias für eine Portnummer ("http", z. B.), die einer Zeichenfolge in der folgenden Datei auf dem lokalen Computer entspricht: %WINDIR%\system32\drivers\etc\services
  • Ein Dienstname, der von einem Namespaceanbieter mithilfe eines SRV-Eintrags aufgelöst werden kann. Der parameter localServiceName kann auch eine leere Zeichenfolge enthalten. Wenn der lokale Dienstname eine leere Zeichenfolge für den lokalen Endpunkt ist, bevor eine Netzwerkverbindung hergestellt wird, stellt das System automatisch eine TCP- oder UDP-IP-Portnummer für die App bereit, die beim Herstellen einer Netzwerkverbindung verwendet werden soll.

Der Konstruktor schlägt fehl, wenn der parameter localServiceName NULL ist.

Der remoteHostName-Parameter kann eine der folgenden Elemente enthalten:

  • Der Name des Remotehosts, der vom Domain Name System (DNS) oder einem anderen Namespaceanbieter aufgelöst werden kann.
  • Der Name des Hosts, der einer Zeichenfolge in der folgenden Datei auf dem lokalen Computer entspricht: %WINDIR%\system32\drivers\etc\hosts
  • Eine Zeichenfolge, die eine IPv4- oder IPv6-Netzwerkadresse des Remotehosts enthält. Eine IPv4-Adresszeichenfolge ist in gepunkteter Dezimalschreibweise ("192.168.1.111", z. B. 192.168.1.111). Eine IPv6-Adresse befindet sich in hexadezimaler Notation ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", z. B. 21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A). Wenn der remoteHostName-Parameter die Zeichenfolge "localhost" ist, stellt dies alle Loopbackadressen auf dem lokalen Computer dar.

Der Konstruktor schlägt fehl, wenn der remoteHostName-Parameter NULL ist oder eine leere Zeichenfolge enthält.

Der remoteServiceName-Parameter kann eine der folgenden Elemente enthalten:

  • Ein numerisches Literal für eine TCP- oder UDP-Portnummer (z. B. 80 für den TCP-Port, der für http verwendet wird).
  • Ein Zeichenfolgenalias für eine Portnummer ("http", z. B.), die einer Zeichenfolge in der folgenden Datei auf dem lokalen Computer entspricht: %WINDIR%\system32\drivers\etc\services
  • Ein Dienstname, der von einem Namespaceanbieter mithilfe eines SRV-Eintrags aufgelöst werden kann. Der Konstruktor schlägt fehl, wenn der remoteServiceName-Parameter NULL ist oder eine leere Zeichenfolge enthält.

Gilt für:

Weitere Informationen