DnssdServiceInstance 類別

定義

命名空間:

Windows.Networking.ServiceDiscovery.Dnssd

封裝使用 DNS 服務探索的服務實例， (DNS-SD) 。

注意

Win32 DNS 服務探索 (DNS-SD) API 會在 windns.h 標頭中宣告。 例如，用於宣告和探索服務的 WIN32 API 為 DnsServiceRegister 和 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

繼承

Object Platform::Object IInspectable DnssdServiceInstance

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IStringable

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

如果您要提供向其他 DNS-SD 使用者公告其本身的服務，或是取用透過 DNS-SD 公告的服務，請使用這個類別。

如果您的程式碼嘗試使用與先前註冊之服務相同的名稱來註冊服務實例，則會重新命名您的服務，以避免在指定名稱結尾加上括弧中的數位來避免衝突。 例如，如果您指定 「mygame」，且該名稱已經註冊另一個服務，您的服務會重新命名為類似 「mygame (2) 」。 完成此動作之後， DnssdRegistrationResult.HasInstanceNameChanged 會設定為 true。

建構函式

DnssdServiceInstance(String, HostName, UInt16)

使用指定的實例名稱、主機名稱和埠，建立新的 DnssdServiceInstance 物件。

屬性

DnssdServiceInstanceName	取得或設定這個 DnssdServiceInstance 的 DNS-SD 服務實例名稱。
HostName	取得或設定這個 DnssdServiceInstance主機的主機名稱。
Port	取得或設定這個 DnssdServiceInstance所使用的埠號碼。
Priority	取得或設定要指派給此服務實例 (的優先順序值，如 RFC 2782 A DNS RR 中所定義，用於指定 DNS SRV) 的服務位置 。 用戶端會使用 優先順序 來決定要附加的數個對等服務實例之哪一個。
TextAttributes	取得此服務實例的屬性，做為字串的 [name， value] 組清單。 服務用戶端可以檢查屬性，以判斷服務實例的其他資訊。 服務所使用的特定屬性名稱和值是由服務的設計工具決定。 例如，多人遊戲的服務實例可能有描述實例所使用的遊戲對應的屬性，或實例的遊戲困難等級。 不同的服務實例會針對不同的地圖或困難等級作用中，而使用遊戲服務的用戶端可以使用屬性值來判斷要針對玩家慣用的地圖或困難等級連線到哪一個遊戲伺服器實例。
Weight	取得或設定指派給此服務實例的加權值，如 RFC 2782中所定義。 用戶端會使用 Weight 值，在具有相同 優先順序 值的伺服器之間進行選擇。

方法

RegisterDatagramSocketAsync(DatagramSocket)	在指定的通訊端上，以非同步方式註冊服務的資料包 (UDP) 通訊端接聽程式。
RegisterDatagramSocketAsync(DatagramSocket, NetworkAdapter)	在指定的通訊端和網路介面卡上，以非同步方式註冊服務的資料包 (UDP) 通訊端接聽程式。
RegisterStreamSocketListenerAsync(StreamSocketListener)	在指定的通訊端上，以非同步方式註冊資料流程 (TCP) 通訊端接聽程式。
RegisterStreamSocketListenerAsync(StreamSocketListener, NetworkAdapter)	在指定的通訊端和網路介面卡上，以非同步方式註冊資料流程 (TCP) 通訊端接聽程式。
ToString()	取得此服務實例的 DNS 伺服器資源記錄 (SRV RR) 作為字串。 如需 DNS SRV RR 的格式和內容的概 念和設施，請參閱 RFC 1034 功能變數名稱 - 概念和設施 ，以及 RFC 2782 和 RFC 6763DNS-Based服務探索 ，以取得 DNS-SD 用戶端和伺服器如何使用這些記錄的詳細資訊。

另請參閱

• IStringable