דף זה תורגם על ידי Cloud Translation API.

DNS - פלטפורמה

המודול הזה כולל את הפשטת הפלטפורמה לשליחת שאילתת DNS רקורסיבית אל שרתי DNS במעלה.

סיכום

ערכי דף
`otPlatDnsUpstreamQuery`	typedef `struct otPlatDnsUpstreamQuery` סוג אטום זה מייצג טרנזקציה של שאילתת DNS במעלה הזרם (upstream).

פונקציות
`otPlatDnsCancelUpstreamQuery(otInstance aInstance, otPlatDnsUpstreamQuery aTxn)`	`void` ביטול עסקה של שאילתה ב-upstream.
`otPlatDnsStartUpstreamQuery(otInstance aInstance, otPlatDnsUpstreamQuery aTxn, const otMessage *aQuery)`	`void` הפונקציה מתחילה טרנזקציית שאילתה מסוג upstream.
`otPlatDnsUpstreamQueryDone(otInstance aInstance, otPlatDnsUpstreamQuery aTxn, otMessage *aResponse)`	`void` הפלטפורמה מפעילה את הפונקציה הזו כדי לסיים שאילתת DNS.

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

סוג אטום זה מייצג טרנזקציה של שאילתת DNS במעלה הזרם (upstream).

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

ביטול עסקה של שאילתה ב-upstream.

כדי לשחרר את המשאבים, הפלטפורמה צריכה לבצע קריאה ל-otPlatDnsUpstreamQueryDone.

פרטים

פרמטרים

`[in] aInstance`	מבנה המכונה של OpenThread.
`[in] aTxn`	מצביע לאובייקט הטרנזקציה של שאילתת ה-DNS האטום.

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

הפונקציה מתחילה טרנזקציית שאילתה מסוג upstream.

במקרה כזה (ושגיאות שמיוצגות על ידי הודעות של פרוטוקול DNS), הפלטפורמה צפויה לבצע קריאה ל-otPlatDnsUpstreamQueryDone.
ליבת OpenThread עשויה לבטל טרנזקציית שאילתה (שעשויה לגרום לזמן קצוב לתפוגה) על ידי קריאה ל-otPlatDnsCancelUpstreamQuery, אסור לפלטפורמה להפעיל otPlatDnsUpstreamQueryDone בעסקה שבוטלה.

פרטים

פרמטרים

`[in] aInstance`	מבנה המכונה של OpenThread.
`[in] aTxn`	מצביע לאובייקט הטרנזקציה של שאילתת ה-DNS האטום.
`[in] aQuery`	מאגר הודעות זמני של המטען הייעודי (payload) של DNS שאמור להישלח לשרת DNS במעלה.

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

הפלטפורמה מפעילה את הפונקציה הזו כדי לסיים שאילתת DNS.

העסקה הזו תבוצע, ולכן אסור לפלטפורמה להתקשר שוב לגבי אותה עסקה פעמיים. הפונקציה הזו מעבירה את הבעלות של aResponse למקבץ OpenThread.

הפלטפורמה יכולה להעביר ערך null כדי לסגור עסקה בלי תגובה.

פרטים

פרמטרים

`[in] aInstance`	מבנה המכונה של OpenThread.
`[in] aTxn`	מצביע לאובייקט הטרנזקציה של שאילתת ה-DNS האטום.
`[in] aResponse`	מאגר הודעות של המטען הייעודי (payload) של תגובת DNS או `nullptr` לסגירת טרנזקציה ללא תגובה.

המקור של נושאי העזר של OpenThread API הוא קוד המקור, שזמין ב-GitHub. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.