Server DNS-SD

Questo modulo include API per il server DNS-SD.

Riepilogo

Enumerazioni

otDnssdQueryType{
  OT_DNSSD_QUERY_TYPE_NONE = 0,
  OT_DNSSD_QUERY_TYPE_BROWSE = 1,
  OT_DNSSD_QUERY_TYPE_RESOLVE = 2,
  OT_DNSSD_QUERY_TYPE_RESOLVE_HOST = 3
}
enum
Questa enumerazione specifica un tipo di query DNS-SD.

Defdef

otDnssdCounters tipodef
Questa struttura contiene i contatori del server DNS-SD.
otDnssdHostInfo tipodef
Questa struttura rappresenta le informazioni di un host rilevato per una query DNS-SD.
otDnssdQuery tipodef
void
Questo tipo opaco rappresenta una query DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) tipodef
void(*
Questa funzione viene chiamata quando una query DNS-SD sottoscrive uno dei seguenti protocolli:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) tipodef
void(*
Questa funzione viene chiamata quando una query DNS-SD annulla l'iscrizione di una delle seguenti opzioni:
otDnssdServiceInstanceInfo tipodef
Questa struttura rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.

Functions

otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Questa funzione restituisce i contatori del server DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Questa funzione acquisisce la query successiva nel server DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Questa funzione acquisisce il tipo e il nome della query DNS-SD per una query specifica.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Questa funzione invia una notifica a un host rilevato.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Questa funzione invia una notifica a un'istanza di servizio rilevata.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Questa funzione imposta i callback delle query server DNS-SD.

Strutture

otDnssdCounters

Questa struttura contiene i contatori del server DNS-SD.

otDnssdHostInfo

Questa struttura rappresenta le informazioni di un host rilevato per una query DNS-SD.

otDnssdServiceInstanceInfo

Questa struttura rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.

Enumerazioni

Tipo di query otDnssd

 otDnssdQueryType

Questa enumerazione specifica un tipo di query DNS-SD.

Proprietà
OT_DNSSD_QUERY_TYPE_BROWSE

Tipo di servizio Sfoglia servizio.

OT_DNSSD_QUERY_TYPE_NONE

Tipo di servizio non specificato.

OT_DNSSD_QUERY_TYPE_RESOLVE

Il tipo di servizio risolve l'istanza di servizio.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Il tipo di servizio risolve il nome host.

Defdef

OtDnssdCounters

struct otDnssdCounters otDnssdCounters

Questa struttura contiene i contatori del server DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Questa struttura rappresenta le informazioni di un host rilevato per una query DNS-SD.

otDnssdQuery

void otDnssdQuery

Questo tipo opaco rappresenta una query DNS-SD.

otDnssdQueryIscriviti per richiamare

void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)

Questa funzione viene chiamata quando una query DNS-SD sottoscrive uno dei seguenti protocolli:

  1. un nome per il servizio.
  2. un nome di istanza di servizio.
  3. un nome host.

L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName. Se aFullName è un nome di servizio o il nome di un'istanza di servizio, l'implementazione della query DNS-SD dovrebbe scoprire le informazioni sull'istanza di servizio corrispondenti e informare il server DNS-SD utilizzando otDnssdQueryHandleDiscoveredServiceInstance. Se aFullName è un nome host, l'implementazione della query DNS-SD dovrebbe scoprire le informazioni sull'host e informare il server DNS-SD utilizzando otDnssdQueryHandleDiscoveredHost.

Dettagli
Parametri
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.
[in] aFullName
Il nome completo del servizio chiuso da null (ad es. "_ipps._tcp.default.service.arpa.") o il nome completo dell'istanza del servizio (ad es. "OpenThread._ipps._tcp.default.service.arpa.") o il nome host completo (ad es. "ot-host.default).
Vedi anche:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryAnnulla la richiamata

void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)

Questa funzione viene chiamata quando una query DNS-SD annulla l'iscrizione di una delle seguenti opzioni:

  1. un nome per il servizio.
  2. un nome di istanza di servizio.
  3. un nome host.

L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName.

Dettagli
Parametri
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.
[in] aFullName
Il nome completo del servizio chiuso da null (ad es. "_ipps._tcp.default.service.arpa.") o il nome completo dell'istanza del servizio (ad es. "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Questa struttura rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.

Functions

OtDnssdGetCounter

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Questa funzione restituisce i contatori del server DNS-SD.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
Restituisce
Un puntatore sui contatori del server DNS-SD.

otDnssdGetNextQuery

const otDnssdQuery * otDnssdGetNextQuery(
  otInstance *aInstance,
  const otDnssdQuery *aQuery
)

Questa funzione acquisisce la query successiva nel server DNS-SD.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aQuery
Il puntatore della query. Passa NULL per ricevere la prima query.
Restituisce
Un puntatore alla query o NULL, se non ci sono più query.

otDnssdGetQueryTypeAndName

otDnssdQueryType otDnssdGetQueryTypeAndName(
  const otDnssdQuery *aQuery,
  char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]
)

Questa funzione acquisisce il tipo e il nome della query DNS-SD per una query specifica.

Dettagli
Parametri
[in] aQuery
Il puntatore della query acquisito da otDnssdGetNextQuery.
[out] aNameOutput
Il buffer di output del nome, che dovrebbe avere una lunghezza di OT_DNS_MAX_NAME_SIZE byte.
Restituisce
Il tipo di query DNS-SD.

otDnssdQueryHandleDiscoveredHost

void otDnssdQueryHandleDiscoveredHost(
  otInstance *aInstance,
  const char *aHostFullName,
  otDnssdHostInfo *aHostInfo
)

Questa funzione invia una notifica a un host rilevato.

Il resolver della query esterna (ad esempio Discovery Proxy) deve chiamare questa funzione per inviare una notifica al core OpenThread degli host a cui hai effettuato l'iscrizione.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aHostFullName
Il nome host completo dal termine null.
[in] aHostInfo
Un puntatore sulle informazioni dell'istanza di servizio rilevate.

otDnssdQueryHandleDiscoveredServiceInstance

void otDnssdQueryHandleDiscoveredServiceInstance(
  otInstance *aInstance,
  const char *aServiceFullName,
  otDnssdServiceInstanceInfo *aInstanceInfo
)

Questa funzione invia una notifica a un'istanza di servizio rilevata.

Il resolver query esterno (ad esempio Discovery Proxy) deve chiamare questa funzione per notificare il core OpenThread dei servizi o delle istanze di servizio in abbonamento.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aServiceFullName
Il nome completo del servizio terminato da null.
[in] aInstanceInfo
Un puntatore sulle informazioni dell'istanza di servizio rilevate.

otDnssdQuerySetCallbacks

void otDnssdQuerySetCallbacks(
  otInstance *aInstance,
  otDnssdQuerySubscribeCallback aSubscribe,
  otDnssdQueryUnsubscribeCallback aUnsubscribe,
  void *aContext
)

Questa funzione imposta i callback delle query server DNS-SD.

Il server DNS-SD chiama aSubscribe per iscriversi a un servizio o un'istanza di servizio per risolvere una query DNS-SD e aUnsubscribe per annullare l'iscrizione quando la query viene risolta o scade.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aSubscribe
Un puntatore alla funzione di callback per abbonarsi a un servizio o a un'istanza di servizio.
[in] aUnsubscribe
Un puntatore sulla funzione di callback per annullare l'iscrizione di un servizio o un'istanza di servizio.
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.

Risorse

Gli argomenti di riferimento per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per ulteriori informazioni o per contribuire alla nostra documentazione, consulta la sezione Risorse.