EndpointPair(HostName, String, HostName, String) Costruttore

Riferimento

Definizione

Spazio dei nomi:: Windows.Networking

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Crea un nuovo oggetto EndpointPair .

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

localHostName: HostName

Nome host locale o indirizzo IP per l'oggetto EndpointPair .

localServiceName: String
Platform::String

winrt::hstring

Nome del servizio locale o numero di porta TCP o UDP locale per l'oggetto EndpointPair .

remoteHostName: HostName

Nome host remoto o indirizzo IP per l'oggetto EndpointPair .

remoteServiceName: String
Platform::String

winrt::hstring

Nome del servizio remoto o numero di porta TCP o UDP remoto per l'oggetto EndpointPair .

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

Condividi tramite