otSrpClientService
#include <srp_client.h>
代表 SRP 客戶服務。
摘要
這個結構中的值 (包括名稱和 TXT 記錄項目的字串緩衝區) 從 otSrpClientAddService()
或 otSrpClientRemoveService()
傳遞至 OpenThread 後,「必須」保留並保持不變。
mState
、mData
、mNext
欄位僅限 OT 核心使用/管理。如果在 otSrpClientAddService()
或 otSrpClientRemoveService()
或其他函式中傳遞 otSrpClientService
的例項,系統就會忽略其值。呼叫端不需要設定這些欄位。
mLease
和 mKeyLease
欄位會指定這項服務的所需租約和金鑰租約間隔時間。零值表示未指定間隔,且這項服務會使用 otSrpClientGetLeaseInterval()
和 otSrpClientGetKeyLeaseInterval()
的預設租約或金鑰租約間隔。如果金鑰租約間隔 (無論是已明確設定,還是由預設值決定) 短於服務的租約間隔,SRP 用戶端也會重複使用金鑰租約間隔的租賃間隔值。舉例來說,如果服務 mLease
已明確設為 2 天,且 mKeyLease
設為 0,並將金鑰租約預設為 1 天,那麼在註冊這項服務時,這項服務要求的金鑰租約也會設為 2 天。
公開屬性 |
|
---|---|
mData
|
uint32_t
內部資料 (由 OT 核心使用)。
|
mInstanceName
|
const char *
服務執行個體名稱標籤 (而非全名)。
|
mKeyLease
|
uint32_t
所需的金鑰租約間隔時間 (以秒為單位,為零) 以使用預設值。
|
mLease
|
uint32_t
想要的租約間隔時間 (以秒 - 0 為單位) 表示使用預設值。
|
mName
|
const char *
服務標籤 (例如「_mt._udp」而非完整網域名稱)。
|
mNext
|
struct otSrpClientService *
連結清單中下一個項目 (由 OT 核心管理) 的遊標。
|
mNumTxtEntries
|
uint8_t
mTxtEntries 陣列中的項目數量。 |
mPort
|
uint16_t
服務通訊埠編號。
|
mPriority
|
uint16_t
服務優先順序。
|
mState
|
服務狀態 (由 OT 核心代管)。
|
mSubTypeLabels
|
const char *const *
子類型標籤的陣列 (必須以
NULL 結尾或為 NULL )。 |
mTxtEntries
|
const otDnsTxtEntry *
TXT 項目陣列 (
mNumTxtEntries 會提供項目數量)。 |
mWeight
|
uint16_t
服務權重。
|
公開屬性
mData
uint32_t otSrpClientService::mData
內部資料 (由 OT 核心使用)。
mInstanceName
const char * otSrpClientService::mInstanceName
服務執行個體名稱標籤 (而非全名)。
mKeyLease
uint32_t otSrpClientService::mKeyLease
所需的金鑰租約間隔時間 (以秒為單位,為零) 以使用預設值。
mLease
uint32_t otSrpClientService::mLease
想要的租約間隔時間 (以秒 - 0 為單位) 表示使用預設值。
mName
const char * otSrpClientService::mName
服務標籤 (例如「_mt._udp」而非完整網域名稱)。
mNumTxtEntries
uint8_t otSrpClientService::mNumTxtEntries
mTxtEntries
陣列中的項目數量。
mPort
uint16_t otSrpClientService::mPort
服務通訊埠編號。
mPriority
uint16_t otSrpClientService::mPriority
服務優先順序。
mSubTypeLabels
const char *const * otSrpClientService::mSubTypeLabels
子類型標籤的陣列 (必須以 NULL
結尾或為 NULL
)。
mTxtEntries
const otDnsTxtEntry * otSrpClientService::mTxtEntries
TXT 項目陣列 (mNumTxtEntries
會提供項目數量)。
mWeight
uint16_t otSrpClientService::mWeight
服務權重。
資源
OpenThread API 參考資料主題源自原始碼,請前往 GitHub 取得。如要瞭解詳情或對說明文件做出貢獻,請參閱資源。