DnssdServiceInstance Classe

Definizione

Spazio dei nomi:

Windows.Networking.ServiceDiscovery.Dnssd

Incapsula un'istanza di un servizio che usa l'individuazione del servizio DNS (DNS-SD).

Nota

Le API di individuazione del servizio DNS Win32 (DNS-SD) vengono dichiarate nell'intestazione windns.h. Ad esempio, le API Win32 per annunciare e individuare i servizi sono DnsServiceRegister e DnsServiceBrowse.

public ref class DnssdServiceInstance sealed : IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Networking.ServiceDiscovery.Dnssd.IDnssdServiceInstanceFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class DnssdServiceInstance final : IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Networking.ServiceDiscovery.Dnssd.IDnssdServiceInstanceFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DnssdServiceInstance : IStringable

function DnssdServiceInstance(dnssdServiceInstanceName, hostName, port)

Public NotInheritable Class DnssdServiceInstance
Implements IStringable

Ereditarietà

Object Platform::Object IInspectable DnssdServiceInstance

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IStringable

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Usare questa classe se si fornisce un servizio che si annuncia ad altri utenti DNS-SD o se si usano servizi annunciati tramite DNS-SD.

Se il codice tenta di registrare un'istanza del servizio con lo stesso nome di un servizio registrato in precedenza, il servizio verrà rinominato per evitare un conflitto aggiungendo un numero tra parentesi alla fine del nome specificato. Ad esempio, se si specifica "mygame" e tale nome è già stato registrato per un altro servizio, il servizio verrà rinominato in un modo simile a "mygame (2)". Al termine, DnssdRegistrationResult.HasInstanceNameChanged è impostato su true.

Costruttori

DnssdServiceInstance(String, HostName, UInt16)

Crea un nuovo oggetto DnssdServiceInstance con il nome dell'istanza, il nome host e la porta specificati.

Proprietà

DnssdServiceInstanceName	Ottiene o imposta il nome dell'istanza del servizio DNS-SD per questo dnssdServiceInstance.
HostName	Ottiene o imposta il nome host dell'host per questo dnssdServiceInstance.
Port	Ottiene o imposta il numero di porta usato da dnssdServiceInstance.
Priority	Ottiene o imposta il valore di priorità da assegnare a questa istanza del servizio, come definito in RFC 2782 A DNS RR per specificare la posizione dei servizi (DNS SRV). I client usano Priorità per decidere a quali istanze di servizio equivalenti connettersi.
TextAttributes	Ottiene gli attributi di questa istanza del servizio come elenco di coppie di stringhe [nome, valore] . Gli attributi possono essere controllati dai client del servizio per determinare informazioni aggiuntive su un'istanza del servizio. I nomi e i valori di attributo specifici usati da un servizio sono determinati dalla finestra di progettazione del servizio. Ad esempio, un'istanza del servizio per un gioco multiplayer potrebbe avere attributi che descrivono quale mappa del gioco sta usando o il livello di difficoltà del gioco dell'istanza. Le istanze di servizio diverse sono attive per mappe o livelli di difficoltà diversi e un client che usa il servizio di gioco può usare i valori dell'attributo per determinare quale istanza del server di gioco connettersi a per il livello di mappa o difficoltà preferito del giocatore.
Weight	Ottiene o imposta il valore di peso assegnato a questa istanza del servizio, come definito in RFC 2782. I client usano il valore Peso per scegliere tra server con lo stesso valore Di priorità .

Metodi

RegisterDatagramSocketAsync(DatagramSocket)	Registra in modo asincrono un listener socket UDP (DataGram) per il servizio, in un determinato socket.
RegisterDatagramSocketAsync(DatagramSocket, NetworkAdapter)	Registra in modo asincrono un listener socket UDP (DataGram) per il servizio, in un determinato socket e scheda di rete.
RegisterStreamSocketListenerAsync(StreamSocketListener)	Registra in modo asincrono un listener socket di flusso (TCP) per il servizio, nel socket specificato.
RegisterStreamSocketListenerAsync(StreamSocketListener, NetworkAdapter)	Registra in modo asincrono un listener socket TCP (Stream) per il servizio, nel socket e nella scheda di rete specificata.
ToString()	Ottiene il record di risorse del server DNS (SRV RR) di questa istanza del servizio, come stringa. Per informazioni dettagliate sul modo in cui i client e i server DNS-SD usano tali record DNS-Based, vedere RFC 1034 DOMAIN NAMES - CONCEPTS AND FACILITIES (NOMI DI DOMINIO RFC 1034 - CONCETTI E STRUTTURE) per informazioni dettagliate sul modo in cui i client e i server DNS-SD usano tali record.

Vedi anche

• IStringable