Servidor DNS-SD
Este módulo incluye API para servidores DNS-SD.
Summary
Enumeraciones |
|
---|---|
otDnssdQueryType{
|
enum En esta enumeración, se especifica un tipo de consulta de DNS-SD. |
Typedefs |
|
---|---|
otDnssdCounters
|
typedefstruct otDnssdCounters
Esta estructura contiene los contadores del servidor DNS-SD. |
otDnssdHostInfo
|
typedefstruct otDnssdHostInfo
Esta estructura representa información de un host detectado para una consulta de DNS-SD. |
otDnssdQuery
|
typedefvoid
Este tipo opaco representa una consulta de DNS-SD. |
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
|
typedefvoid(*
Se llama a esta función cuando una consulta de DNS-SD se suscribe a una de las siguientes opciones: |
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
|
typedefvoid(*
Se llama a esta función cuando una búsqueda de DNS-SD anula una de las siguientes opciones: |
otDnssdServiceInstanceInfo
|
typedefstruct otDnssdServiceInstanceInfo
Esta estructura representa información de una instancia de servicio descubierta para una consulta de DNS-SD. |
Funciones |
|
---|---|
otDnssdGetCounters(otInstance *aInstance)
|
const otDnssdCounters *
Esta función muestra los contadores del servidor DNS-SD.
|
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
|
const otDnssdQuery *
Esta función adquiere la siguiente consulta en el servidor DNS-SD.
|
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
|
Esta función adquiere el tipo de consulta DNS-SD y el nombre de una consulta específica.
|
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
|
void
Esta función notifica a un host detectado.
|
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
|
void
Esta función notifica a una instancia de servicio descubierta.
|
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
|
void
Esta función establece devoluciones de llamada de consulta del servidor DNS-SD.
|
Structs |
|
---|---|
otDnssdCounters |
Esta estructura contiene los contadores del servidor DNS-SD. |
otDnssdHostInfo |
Esta estructura representa información de un host detectado para una consulta de DNS-SD. |
otDnssdServiceInstanceInfo |
Esta estructura representa información de una instancia de servicio descubierta para una consulta de DNS-SD. |
Enumeraciones
Tipo de consulta otDssd
otDnssdQueryType
En esta enumeración, se especifica un tipo de consulta de DNS-SD.
Properties | |
---|---|
OT_DNSSD_QUERY_TYPE_BROWSE
|
Servicio de navegación por tipos de servicios. |
OT_DNSSD_QUERY_TYPE_NONE
|
Tipo de servicio sin especificar. |
OT_DNSSD_QUERY_TYPE_RESOLVE
|
El tipo de servicio resuelve la instancia de servicio. |
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST
|
El tipo de servicio resuelve el nombre de host. |
Typedefs
otDnssdCounters
struct otDnssdCounters otDnssdCounters
Esta estructura contiene los contadores del servidor DNS-SD.
otDnssdHostInfo
struct otDnssdHostInfo otDnssdHostInfo
Esta estructura representa información de un host detectado para una consulta de DNS-SD.
otDnssdQuery
void otDnssdQuery
Este tipo opaco representa una consulta de DNS-SD.
otDnssdQuerySubscribeCallback
void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
Se llama a esta función cuando una consulta de DNS-SD se suscribe a una de las siguientes opciones:
- un nombre de servicio.
- el nombre de una instancia de servicio.
- un nombre de host
La implementación de la consulta DNS-SD es responsable de identificar qué es aFullName
. Si aFullName
es un nombre de servicio o nombre de instancia de servicio, la implementación de una consulta DNS-SD debería detectar la información de la instancia de servicio correspondiente y notificar al servidor DNS-SD con otDnssdQueryHandleDiscoveredServiceInstance
. Si aFullName
es un nombre de host, la implementación de la consulta DNS-SD debe detectar la información del host y notificar al servidor DNS-SD con otDnssdQueryHandleDiscoveredHost
.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost
otDnssdQueryunsubscribeCallback
void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
Se llama a esta función cuando una búsqueda de DNS-SD anula una de las siguientes opciones:
- un nombre de servicio.
- el nombre de una instancia de servicio.
- un nombre de host
La implementación de la consulta de DNS-SD es responsable de identificar qué es aFullName
.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otDnssdServiceInstanceInfo
struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo
Esta estructura representa información de una instancia de servicio descubierta para una consulta de DNS-SD.
Funciones
otDnssdGetCounters
const otDnssdCounters * otDnssdGetCounters( otInstance *aInstance )
Esta función muestra los contadores del servidor DNS-SD.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Un puntero para los contadores del servidor DNS-SD.
|
otDnssdGetNextQuery
const otDnssdQuery * otDnssdGetNextQuery( otInstance *aInstance, const otDnssdQuery *aQuery )
Esta función adquiere la siguiente consulta en el servidor DNS-SD.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Qué muestra |
Un puntero para la consulta o NULL si no hay más consultas.
|
otDnssdGetQueryTypeAndName
otDnssdQueryType otDnssdGetQueryTypeAndName( const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE] )
Esta función adquiere el tipo de consulta DNS-SD y el nombre de una consulta específica.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Qué muestra |
Es el tipo de consulta de DNS-SD.
|
otDnssdQueryHandleDiscoveredHost
void otDnssdQueryHandleDiscoveredHost( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo )
Esta función notifica a un host detectado.
El agente de resolución de consultas externas (p.ej., el proxy de descubrimiento) debe llamar a esta función para notificar a OpenThread Core sobre los hosts a los que se suscribió.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
otDnssdQueryHandleDiscoveredServiceInstance
void otDnssdQueryHandleDiscoveredServiceInstance( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo )
Esta función notifica a una instancia de servicio descubierta.
El agente de resolución de consultas externas (p.ej., proxy de descubrimiento) debe llamar a esta función para notificar a OpenThread principal de los servicios a los que se suscribió o las instancias de servicio.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
otDnssdQuerySetCallbacks
void otDnssdQuerySetCallbacks( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext )
Esta función establece devoluciones de llamada de consulta del servidor DNS-SD.
El servidor DNS-SD llama a aSubscribe
a fin de suscribirse a un servicio o instancia de servicio para resolver una consulta de DNS-SD y a aUnsubscribe
para anular la suscripción cuando se resuelve la consulta o se agota el tiempo de espera.
Detalles | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
Recursos
Los temas de referencia de la API de OpenThread se originan en el código fuente, disponible en GitHub. Para obtener más información o colaborar con nuestra documentación, consulta Recursos.