DnssdServiceInstance Clase

  • Referencia

Definición

Espacio de nombres:
Windows.Networking.ServiceDiscovery.Dnssd
Editar

Encapsula una instancia de un servicio que usa la detección de servicios DNS (DNS-SD).

Nota

Las API de detección de servicios DNS (DNS-SD) de Win32 se declaran en el encabezado windns.h. Por ejemplo, las API de Win32 para anunciar y detectar servicios son DnsServiceRegister y 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
Herencia
Object Platform::Object IInspectable DnssdServiceInstance
Atributos
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementaciones
IStringable

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Use esta clase si va a proporcionar un servicio que se anuncia a sí mismo a otros usuarios de DNS-SD o si usa servicios anunciados a través de DNS-SD.

Si el código intenta registrar una instancia de servicio con el mismo nombre que un servicio registrado anteriormente, se cambiará el nombre del servicio para evitar un conflicto agregando un número entre paréntesis al final del nombre especificado. Por ejemplo, si especificó "mygame" y ese nombre ya estaba registrado para otro servicio, el servicio se cambiaría por algo parecido a "mygame (2)". Cuando esto se hace, DnssdRegistrationResult.HasInstanceNameChanged se establece en true.

Constructores

DnssdServiceInstance(String, HostName, UInt16)

Crea un nuevo objeto DnssdServiceInstance con el nombre de instancia, el nombre de host y el puerto especificados.

Propiedades

DnssdServiceInstanceName

Obtiene o establece el nombre de la instancia del servicio DNS-SD para este dnssdServiceInstance.
HostName

Obtiene o establece el nombre de host del host para este DnssdServiceInstance.
Port

Obtiene o establece el número de puerto usado por este DnssdServiceInstance.
Priority

Obtiene o establece el valor de prioridad que se va a asignar a esta instancia de servicio, tal como se define en RFC 2782 A DNS RR para especificar la ubicación de los servicios (SRV de DNS). Los clientes usan Priority para decidir a qué instancias de servicio equivalentes se van a adjuntar.
TextAttributes

Obtiene los atributos de esta instancia de servicio, como una lista de pares [nombre, valor] de cadenas. Los clientes de servicio pueden inspeccionar los atributos para determinar información adicional sobre una instancia de servicio.

El diseñador del servicio determina los nombres y valores de atributo específicos que usa un servicio. Por ejemplo, una instancia de servicio para un juego multijugador podría tener atributos que describen qué mapa de juego está usando la instancia o el nivel de dificultad del juego de la instancia. Diferentes instancias de servicio estarían activas para diferentes mapas o niveles de dificultad, y un cliente que usa el servicio de juego podría usar los valores de atributo para determinar a qué instancia del servidor de juegos conectarse para el nivel de asignación o dificultad preferidos del jugador.
Weight

Obtiene o establece el valor de peso asignado a esta instancia de servicio, tal como se define en RFC 2782. Los clientes usan el valor weight para elegir entre servidores con el mismo valor de prioridad .

Métodos

RegisterDatagramSocketAsync(DatagramSocket)

Registra de forma asincrónica un agente de escucha de socket de datagrama (UDP) para el servicio, en un socket determinado.
RegisterDatagramSocketAsync(DatagramSocket, NetworkAdapter)

Registra de forma asincrónica un agente de escucha de socket de datagrama (UDP) para el servicio, en un adaptador de red y socket determinado.
RegisterStreamSocketListenerAsync(StreamSocketListener)

Registra de forma asincrónica un agente de escucha de socket de flujo (TCP) para el servicio, en el socket especificado.
RegisterStreamSocketListenerAsync(StreamSocketListener, NetworkAdapter)

Registra de forma asincrónica un agente de escucha de socket de flujo (TCP) para el servicio, en el socket y el adaptador de red especificados.
ToString()

Obtiene el registro de recursos del servidor DNS (SRV RR) de esta instancia de servicio, como una cadena.

Consulte RFC 1034 DOMAIN NAMES - CONCEPTS AND FACILITIES (NOMBRES DE DOMINIO RFC 1034: CONCEPTOS E INSTALACIONES ) para conocer el formato y el contenido de DNS SRV RR, y RFC 2782 y RFC 6763 DNS-Based Service Discovery para obtener más información sobre cómo los clientes y servidores DNS-SD usan esos registros.

Se aplica a

Consulte también