Serwer DNS-SD

Ten moduł zawiera interfejsy API serwera DNS-SD.

Podsumowanie

Wyliczenia
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 | typ wyliczeniowy Określa typ zapytania DNS-SD.

Definicje typów
otDnssdCounters	typedef struct otDnssdCounters Zawiera liczniki serwera DNS-SD.
otDnssdHostInfo	typedef struct otDnssdHostInfo Reprezentuje informacje o wykrytym hoście dla zapytania DNS-SD.
otDnssdQuery	typedef void Ten nieprzejrzysty typ reprezentuje zapytanie DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* Jest wywoływane, gdy zapytanie DNS-SD subskrybuje jedno z tych elementów:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* Jest wywoływane, gdy zapytanie DNS-SD anuluje subskrypcję:
otDnssdServiceInstanceInfo	typedef struct otDnssdServiceInstanceInfo Reprezentuje informacje o wykrytej instancji usługi dla zapytania DNS-SD.

Funkcje
otDnssdGetCounters(otInstance *aInstance)	const otDnssdCounters * Zwraca liczniki serwera DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)	const otDnssdQuery * Przetwarza następne zapytanie na serwerze DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])	otDnssdQueryType Pozyskuje typ zapytania DNS-SD i nazwę konkretnego zapytania.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)	void Powiadamia wykrytego hosta.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)	void Powiadamia wykrytą instancję usługi.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)	void Ustawia wywołania zwrotne zapytania serwera DNS-SD.
otDnssdUpstreamQueryIsEnabled(otInstance *aInstance)	bool Zwraca, czy serwer DNSSD przekierowuje zapytania DNS do nadrzędnego interfejsu API DNS platformy.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)	void Włącz lub wyłącz przekierowanie zapytań DNS do interfejsu API platformy DNS na platformie.

Konstrukcja
otDnssdCounters	Zawiera liczniki serwera DNS-SD.
otDnssdHostInfo	Reprezentuje informacje o wykrytym hoście dla zapytania DNS-SD.
otDnssdServiceInstanceInfo	Reprezentuje informacje o wykrytej instancji usługi dla zapytania DNS-SD.

Wyliczenia

otDnssdQueryType

 otDnssdQueryType

Określa typ zapytania DNS-SD.

Właściwości
OT_DNSSD_QUERY_TYPE_BROWSE	Usługa przeglądania typu usługi.
OT_DNSSD_QUERY_TYPE_NONE	Nie określono typu usługi.
OT_DNSSD_QUERY_TYPE_RESOLVE	Typ usługi rozstrzygaj instancję usługi.
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST	Typ usługi jest rozpoznawany nazwę hosta.

Definicje typów

otDnssdCounters

struct otDnssdCounters otDnssdCounters

Zawiera liczniki serwera DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Reprezentuje informacje o wykrytym hoście dla zapytania DNS-SD.

otDnssdQuery

void otDnssdQuery

Ten nieprzejrzysty typ reprezentuje zapytanie DNS-SD.

otDnssdQuerySubscribeCallback

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

Jest wywoływane, gdy zapytanie DNS-SD subskrybuje jedno z tych elementów:

1. nazwę usługi.
2. nazwę instancji usługi.
3. nazwę hosta.

Implementacja zapytania DNS-SD odpowiada za identyfikację aFullName. Jeśli aFullName jest nazwą usługi lub instancji usługi, implementacja zapytania DNS-SD powinna wykryć odpowiednie informacje o instancji usługi i powiadomić serwer DNS-SD za pomocą otDnssdQueryHandleDiscoveredServiceInstance. Jeśli aFullName jest nazwą hosta, implementacja zapytania DNS-SD powinna wykryć informacje o hoście i powiadomić serwer DNS-SD za pomocą otDnssdQueryHandleDiscoveredHost.

Uwaga: tę samą nazwę może mieć kilka subskrypcji. Implementacja zapytań DNS-SD powinna rejestrować liczbę aktywnych subskrypcji i przestać powiadamiać o braku aktywnej subskrypcji dla aFullName.

Szczegóły
Parametry	[in] aContext Wskaźnik do kontekstu aplikacji. [in] aFullName Pełna nazwa usługi zakończona wartością null (np. „_ipps._tcp.default.service.arpa.”) lub pełna nazwa instancji usługi (np. „OpenThread._ipps._tcp.default.service.arpa.”) lub pełna nazwa hosta (np. „ot-host.default.service.arpa.”).

Zobacz też:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

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

Jest wywoływane, gdy zapytanie DNS-SD anuluje subskrypcję:

1. nazwę usługi.
2. nazwę instancji usługi.
3. nazwę hosta.

Implementacja zapytań DNS-SD odpowiada za określenie, czym jest aFullName.

Uwaga: tę samą nazwę może mieć kilka subskrypcji. Implementacja zapytań DNS-SD powinna rejestrować liczbę aktywnych subskrypcji i przestać powiadamiać o braku aktywnej subskrypcji dla aFullName.

Szczegóły
Parametry	[in] aContext Wskaźnik do kontekstu aplikacji. [in] aFullName Pełna nazwa usługi zakończona wartością null (np. „_ipps._tcp.default.service.arpa.”) lub pełna nazwa instancji usługi (np. „OpenThread._ipps._tcp.default.service.arpa.”).

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Reprezentuje informacje o wykrytej instancji usługi dla zapytania DNS-SD.

Funkcje

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Zwraca liczniki serwera DNS-SD.

Szczegóły
Parametry	[in] aInstance Struktura instancji OpenThread.
Zwroty	Wskaźnik do liczników serwera DNS-SD.

otDnssdGetNextQuery

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

Przetwarza następne zapytanie na serwerze DNS-SD.

Szczegóły
Parametry	[in] aInstance Struktura instancji OpenThread. [in] aQuery Wskaźnik zapytania. Aby uzyskać pierwsze zapytanie, przekaż wartość NULL.
Zwroty	Wskaźnik do zapytania lub wartość NULL, jeśli nie ma więcej zapytań.

otDnssdGetQueryTypeAndName

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

Pozyskuje typ zapytania DNS-SD i nazwę konkretnego zapytania.

Szczegóły
Parametry	[in] aQuery Wskaźnik zapytania pobrany z otDnssdGetNextQuery. [out] aNameOutput Bufor danych wyjściowych nazwy, który powinien mieć OT_DNS_MAX_NAME_SIZE bajtów.
Zwroty	Typ zapytania DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Powiadamia wykrytego hosta.

Zewnętrzny program do rozpoznawania zapytań (np. serwer proxy wykrywania) powinien wywoływać tę funkcję, aby powiadomić rdzeń OpenThread o subskrybowanych hostach.

Uwaga: aHostInfo nie może zawierać nieokreślonych adresów IP, adresów IP połączenia lokalnego, zapętlenia ani multiemisji.

Szczegóły
Parametry	[in] aInstance Struktura instancji OpenThread. [in] aHostFullName Pełna nazwa hosta zakończona wartością null. [in] aHostInfo Wskaźnik do informacji o wykrytej instancji usługi.

otDnssdQueryHandleDiscoveredServiceInstance

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

Powiadamia wykrytą instancję usługi.

Zewnętrzny program do rozpoznawania zapytań (np. serwer proxy wykrywania) powinien wywoływać tę funkcję, aby powiadomić rdzenia OpenThread o subskrybowanych usługach lub instancjach usług.

Uwaga: aInstanceInfo nie może zawierać nieokreślonych adresów IP, adresów IP połączenia lokalnego, zapętlenia ani multiemisji.

Szczegóły
Parametry	[in] aInstance Struktura instancji OpenThread. [in] aServiceFullName Pełna nazwa usługi zakończona wartością null. [in] aInstanceInfo Wskaźnik do informacji o wykrytej instancji usługi.

otDnssdQuerySetCallbacks

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

Ustawia wywołania zwrotne zapytania serwera DNS-SD.

Serwer DNS-SD wywołuje metodę aSubscribe, aby zasubskrybować usługę lub instancję usługi, aby rozwiązać zapytanie DNS-SD, i aUnsubscribe, aby anulować subskrypcję po zakończeniu zapytania lub po upływie limitu czasu.

Uwaga: opcje aSubscribe i aUnsubscribe muszą być ustawione lub nieskonfigurowane.

Szczegóły
Parametry	[in] aInstance Struktura instancji OpenThread. [in] aSubscribe Wskaźnik do funkcji wywołania zwrotnego, która umożliwia subskrybowanie usługi lub jej instancji. [in] aUnsubscribe Wskaźnik do funkcji wywołania zwrotnego, która umożliwia anulowanie subskrypcji usługi lub instancji usługi. [in] aContext Wskaźnik do kontekstu aplikacji.

otDnssdUpstreamQueryIsEnabled

bool otDnssdUpstreamQueryIsEnabled(
  otInstance *aInstance
)

Zwraca, czy serwer DNSSD przekierowuje zapytania DNS do nadrzędnego interfejsu API DNS platformy.

Dostępne, gdy włączono OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE.

Szczegóły
Parametry	[in] aInstance Wskaźnik do instancji OpenThread.
Zwracane wartości	TRUE Czy serwer DNSSD przekazuje zapytania DNS. FALSE Jeśli serwer DNSSD nie przekierowuje zapytań DNS:

Zobacz też:
otDnssdUpstreamQuerySetEnabled

otDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Włącz lub wyłącz przekierowanie zapytań DNS do interfejsu API platformy DNS na platformie.

Dostępne, gdy włączono OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE.

Szczegóły
Parametry	[in] aInstance Wskaźnik do instancji OpenThread. [in] aEnabled Wartość logiczna służąca do włączania/wyłączania przekazywania zapytań DNS na serwer nadrzędny.

Zobacz też:
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone

Zasoby

Tematy referencyjne interfejsu OpenThread API pochodzą z kodu źródłowego dostępnego w GitHub. Aby dowiedzieć się więcej lub dołączyć do naszej dokumentacji, skorzystaj z sekcji Zasoby.