EndpointPair(HostName, String, HostName, String) Costruttore

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)

Parametri

Commenti

Questo costruttore crea un nuovo oggetto EndpointPair da un nome host locale, un nome del servizio locale, un nome host remoto e un nome del servizio remoto. L'oggetto EndpointPair fornisce dati usati dalle app di rete per l'endpoint locale e l'endpoint remoto per una connessione di rete.

Un endpoint è costituito da due componenti:

• Nome host o indirizzo IP.

• Nome del servizio o numero di porta TCP o UDP. Una coppia di endpoint è costituita da due componenti:

• Endpoint locale per una connessione di rete.

• Endpoint remoto per una connessione di rete. Il parametro localHostName può contenere uno dei seguenti elementi:

• Nome dell'host locale che può essere risolto dal dns (Domain Name System) o da un altro provider di spazi dei nomi.

• Nome dell'host locale che corrisponde a una stringa nel file seguente nel computer locale: %WINDIR%\system32\drivers\etc\host

• Stringa che contiene un indirizzo di rete IPv4 o IPv6 dell'host locale. Una stringa di indirizzi IPv4 è in notazione decimale tratteggiata ("192.168.1.111", ad esempio). Un indirizzo IPv6 si trova nella notazione esadecimale ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", ad esempio). Se il parametro localHostName è la stringa "localhost", questo rappresenta tutti gli indirizzi di loopback nel computer locale.

Il metodo NetworkInformation.GetHostNames nello spazio dei nomi Windows.Networking.Connectivity può essere usato per recuperare un elenco di nomi host o indirizzi IP associati al computer locale. Uno di questi nomi host o indirizzi IP può quindi essere usato per il parametro localHostName .

Il parametro localHostName può anche essere impostato su Null. Se localHostName è null prima che venga stabilita una connessione di rete da un'app client, il sistema fornirà automaticamente l'indirizzo IP locale per l'uso dell'app.

Il parametro localServiceName può contenere uno dei seguenti elementi:

• Valore letterale numerico per un numero di porta TCP o UDP (80 per la porta TCP usata per http, ad esempio).
• Alias stringa per un numero di porta ("http", ad esempio) che corrisponde a una stringa nel file seguente nel computer locale: %WINDIR%\system32\drivers\etc\services
• Nome del servizio che può essere risolto da un provider di spazi dei nomi usando un record SRV. Il parametro localServiceName può contenere anche una stringa vuota. Se il nome del servizio locale è una stringa vuota per l'endpoint locale prima che venga stabilita una connessione di rete, il sistema fornirà automaticamente un numero di porta TCP o UDP IP da usare per l'app quando si stabilisce una connessione di rete.

Il costruttore avrà esito negativo se il parametro localServiceName è Null.

Il parametro remoteHostName può contenere uno dei seguenti elementi:

• Nome dell'host remoto che può essere risolto dal dns (Domain Name System) o da un altro provider di spazi dei nomi.
• Nome dell'host che corrisponde a una stringa nel file seguente nel computer locale: %WINDIR%\system32\drivers\etc\host
• Stringa che contiene un indirizzo di rete IPv4 o IPv6 dell'host remoto. Una stringa di indirizzi IPv4 è in notazione decimale tratteggiata ("192.168.1.111", ad esempio). Un indirizzo IPv6 si trova nella notazione esadecimale ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", ad esempio). Se il parametro remoteHostName è la stringa "localhost", questo rappresenta tutti gli indirizzi di loopback nel computer locale.

Il costruttore avrà esito negativo se il parametro remoteHostName è Null o contiene una stringa vuota.

Il parametro remoteServiceName può contenere uno dei seguenti elementi:

• Valore letterale numerico per un numero di porta TCP o UDP (80 per la porta TCP usata per http, ad esempio).
• Alias stringa per un numero di porta ("http", ad esempio) che corrisponde a una stringa nel file seguente nel computer locale: %WINDIR%\system32\drivers\etc\services
• Nome del servizio che può essere risolto da un provider di spazi dei nomi usando un record SRV. Il costruttore avrà esito negativo se il parametro remoteServiceName è Null o contiene una stringa vuota.

Si applica a

Vedi anche

• Windows.Networking