Freigeben über


DnssdServiceInstance Klasse

Definition

Kapselt eine Instanz eines Diensts, der die DNS-Dienstermittlung (DNS-SD) verwendet.

Hinweis

Win32 DNS Service Discovery (DNS-SD)-APIs werden im windns.h-Header deklariert. Beispielsweise sind die Win32-APIs zum Ankündigen und Ermitteln von Diensten DnsServiceRegister und DnsServiceBrowse.

public ref class DnssdServiceInstance sealed : IStringable
/// [Windows.Foundation.Metadata.Activatable(Windows.Networking.ServiceDiscovery.Dnssd.IDnssdServiceInstanceFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class DnssdServiceInstance final : 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.Activatable(typeof(Windows.Networking.ServiceDiscovery.Dnssd.IDnssdServiceInstanceFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class DnssdServiceInstance : 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
Vererbung
Object Platform::Object IInspectable DnssdServiceInstance
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Verwenden Sie diese Klasse, wenn Sie einen Dienst bereitstellen, der sich selbst für andere DNS-SD-Benutzer angibt, oder wenn Sie Dienste nutzen, die über DNS-SD angekündigt werden.

Wenn Ihr Code versucht, eine Dienstinstanz mit demselben Namen wie ein zuvor registrierter Dienst zu registrieren, wird Ihr Dienst umbenannt, um einen Konflikt zu vermeiden, indem am Ende des angegebenen Namens eine Zahl in Klammern hinzugefügt wird. Wenn Sie beispielsweise "mygame" angegeben haben und dieser Name bereits für einen anderen Dienst registriert wurde, wird Ihr Dienst in etwa "mygame (2)" umbenannt. Wenn dies geschehen ist, wird DnssdRegistrationResult.HasInstanceNameChanged auf true festgelegt.

Konstruktoren

DnssdServiceInstance(String, HostName, UInt16)

Erstellt ein neues DnssdServiceInstance-Objekt mit dem angegebenen Instanznamen, Hostnamen und Port.

Eigenschaften

DnssdServiceInstanceName

Ruft den DNS-SD-Dienstinstanznamen für diese DnssdServiceInstance ab oder legt diesen fest.

HostName

Ruft den Hostnamen des Hosts für diese DnssdServiceInstance ab oder legt diesen fest.

Port

Ruft die Portnummer ab, die von dieser DnssdServiceInstance verwendet wird, oder legt sie fest.

Priority

Ruft den Prioritätswert ab, der dieser Dienstinstanz zugewiesen werden soll, wie in RFC 2782 A DNS RR zum Angeben des Speicherorts von Diensten (DNS SRV) definiert, oder legt diesen fest. Clients verwenden Priorität , um zu entscheiden, an welche von mehreren gleichwertigen Dienstinstanzen angefügt werden soll.

TextAttributes

Ruft die Attribute dieser Dienstinstanz als Liste von [Name, Wert]-Paaren von Zeichenfolgen ab. Attribute können von Dienstclients überprüft werden, um zusätzliche Informationen zu einer Dienstinstanz zu ermitteln.

Die spezifischen Attributnamen und Werte, die von einem Dienst verwendet werden, werden vom Designer des Diensts bestimmt. Beispielsweise kann eine Dienstinstanz für ein Multiplayer-Spiel Attribute aufweisen, die beschreiben, welche Spielkarte die Instanz verwendet, oder den Spiel-Schwierigkeitsgrad der Instanz. Verschiedene Dienstinstanzen wären für verschiedene Karten oder Schwierigkeitsstufen aktiv, und ein Client, der den Spieldienst verwendet, könnte die Attributwerte verwenden, um zu bestimmen, mit welcher Gameserverinstanz für die bevorzugte Karte oder schwierigkeitsgrad des Spielers eine Verbindung hergestellt werden soll.

Weight

Ruft den Gewichtungswert ab, der dieser Dienstinstanz zugewiesen ist, wie in RFC 2782 definiert, oder legt diesen fest. Clients verwenden den Gewichtungswert , um zwischen Servern mit demselben Prioritätswert auszuwählen.

Methoden

RegisterDatagramSocketAsync(DatagramSocket)

Registriert asynchron einen Udp-Socketlistener (Datagram) für den Dienst in einem bestimmten Socket.

RegisterDatagramSocketAsync(DatagramSocket, NetworkAdapter)

Registriert asynchron einen UDP-Socketlistener (Datagram) für den Dienst auf einem bestimmten Socket und Netzwerkadapter.

RegisterStreamSocketListenerAsync(StreamSocketListener)

Registriert asynchron einen TCP-Socketlistener (Stream) für den Dienst im angegebenen Socket.

RegisterStreamSocketListenerAsync(StreamSocketListener, NetworkAdapter)

Registriert asynchron einen TCP-Socketlistener (Stream) für den Dienst auf dem angegebenen Socket und Netzwerkadapter.

ToString()

Ruft den DNS-Serverressourceneintrag (SRV RR) dieser Dienstinstanz als Zeichenfolge ab.

Ausführliche Informationen zur Verwendung dieser Datensätze finden Sie unter RFC 1034 DOMAIN NAMES – CONCEPTS AND FACILITIES (RFC 1034 DOMAIN NAMES – CONCEPTS AND FACILITIES ) für Format und Inhalt der DNS SRV RR und RFC 2782 und RFC 6763 DNS-Based Service Discovery .

Gilt für:

Weitere Informationen