DnssdServiceInstance クラス

リファレンス

定義

名前空間:: Windows.Networking.ServiceDiscovery.Dnssd

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

DNS サービス探索 (DNS-SD) を使用するサービスのインスタンスをカプセル化します。

Note

Win32 DNS Service Discovery (DNS-SD) API は windns.h ヘッダーで宣言されています。たとえば、サービスをアナウンスおよび検出するための Win32 API は、DnsServiceRegister と 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

継承: 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	サービスの場所 (DNS SRV) を指定するための RFC 2782 A DNS RR で定義されているように、このサービスインスタンスに割り当てる優先度の値を取得または設定します。クライアントは Priority を使用して、アタッチする同等のサービスインスタンスを決定します。
TextAttributes	文字列の [名前、値] ペアの一覧として、このサービスインスタンスの属性を取得します。属性は、サービスクライアントによって検査され、サービスインスタンスに関する追加情報を特定できます。サービスによって使用される特定の属性名と値は、サービスのデザイナーによって決定されます。たとえば、マルチプレイヤーゲームのサービスインスタンスには、インスタンスが使用しているゲームマップを記述する属性や、インスタンスのゲームの難易度を記述する属性が含まれている場合があります。マップや難易度レベルごとに異なるサービスインスタンスがアクティブになり、ゲームサービスを使用するクライアントは属性値を使用して、プレーヤーの優先マップまたは難易度レベルに接続するゲームサーバーインスタンスを決定できます。
Weight	RFC 2782 で定義されているように、このサービスインスタンスに割り当てられる重み値を取得または設定します。クライアントは、重みの値を使用して、同じ Priority 値を持つサーバーを選択します。

メソッド

RegisterDatagramSocketAsync(DatagramSocket)	特定のソケットに、サービスのデータグラム (UDP) ソケットリスナーを非同期に登録します。
RegisterDatagramSocketAsync(DatagramSocket, NetworkAdapter)	特定のソケットとネットワークアダプターに、サービスのデータグラム (UDP) ソケットリスナーを非同期に登録します。
RegisterStreamSocketListenerAsync(StreamSocketListener)	特定のソケットに、サービスのストリーム (TCP) ソケットリスナーを非同期に登録します。
RegisterStreamSocketListenerAsync(StreamSocketListener, NetworkAdapter)	特定のソケットとネットワークアダプターに、サービスのストリーム (TCP) ソケットリスナーを非同期に登録します。
ToString()	このサービスインスタンスの DNS サーバーリソースレコード (SRV RR) を文字列として取得します。 DNS SRV RR の形式と内容については RFC 1034 ドメイン名 - 概念と機能に関するページを参照し、DNS-SD クライアントとサーバーでこれらのレコードを使用する方法の詳細については、 RFC 2782 と RFC 6763 DNS-Based Service Discovery を参照してください。

適用対象

こちらもご覧ください

IStringable

次の方法で共有