nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager

#include <src/lib/profiles/service-directory/ServiceDirectory.h>

كائن المدير لدليل خدمة Weave.

ملخّص

مدير خدمة Weave هو الواجهة الرئيسية لتطبيقات خدمة الدليل. وبناءً على ذلك، يخفي التعقيدات الكامنة في البحث عن إدخال الدليل المرتبط بنقطة نهاية الخدمة، وإجراء بحث نظام أسماء النطاقات على اسم أو أكثر من أسماء المضيفين هناك، ومحاولة الاتصال، وتأمين الاتصال، وما إلى ذلك. وقد يدير أيضًا ذاكرة تخزين مؤقت لمعلومات دليل الخدمة.

الشركات المصنّعة والمُصنّعة
WeaveServiceManager(void)
تعمل هذه الطريقة على إعداد مثيل WeaveServiceManager.
~WeaveServiceManager(void)
تؤدي هذه الطريقة إلى إتلاف مثيل WeaveServiceManager.

الأنواع العامة
@303{
  kWeave_DefaultSendTimeout = 15000
} 		تعداد
OnConnectBegin)(struct ServiceConnectBeginArgs &args) nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager::OnConnectBegin
void(*
استدعاء تطبيق يتم إجراؤه قبل إنشاء الاتصال مباشرةً.
OnServiceEndpointQueryBegin)(void) nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager::OnServiceEndpointQueryBegin
void(*
استدعاء تطبيق لتحديد وقت طلب بحث دليل خدمة صادر.
OnServiceEndpointQueryEndWithTimeInfo)(uint64_t timeQueryReceiptMsec, uint32_t timeProcessMsec) nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager::OnServiceEndpointQueryEndWithTimeInfo
void(*
استدعاء تطبيق لتقديم قيم الوقت من رد دليل الخدمة.
RootDirectoryAccessor)(uint8_t *aDirectory, uint16_t aLength) nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager::RootDirectoryAccessor
دالة موصّل لمعلومات الدليل الجذر.
StatusHandler)(void *anAppState, WEAVE_ERROR anError, StatusReport *aStatusReport) nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager::StatusHandler
void(*
يشير ذلك المصطلح إلى معالج لشروط الحالة والأخطاء.

وظائف عامة
SetConnectBeginCallback(OnConnectBegin aConnectBegin)
void
إعداد دالة رد الاتصال التي سيتم طلبها قبل إنشاء الاتصال مباشرةً.
cancel(uint64_t aServiceEp, void *aAppState)
void
تؤدي هذه الطريقة إلى إلغاء طلب الربط.
clearCache(void)
void
تمحو هذه الطريقة حالة المدير وذاكرة التخزين المؤقت فيه إذا كانت الحالة في الوحدة الطرفية kServiceMgrState_solutionsd، ما يعني أنه تم تلقّي الاستجابة من نقطة نهاية "دليل الخدمة".
connect(uint64_t aServiceEp, WeaveAuthMode aAuthMode, void *aAppState, StatusHandler aStatusHandler, WeaveConnection::ConnectionCompleteFunct aConnectionCompleteHandler, const uint32_t aConnectTimeoutMsecs, const InterfaceId aConnectIntf)
تطلب هذه الطريقة الاتصال بخدمة Weave.
init(WeaveExchangeManager *aExchangeMgr, uint8_t *aCache, uint16_t aCacheLen, RootDirectoryAccessor aAccessor, WeaveAuthMode aDirAuthMode, OnServiceEndpointQueryBegin aServiceEndpointQueryBegin, OnServiceEndpointQueryEndWithTimeInfo aServiceEndpointQueryEndWithTimeInfo, OnConnectBegin aConnectBegin)
تعمل هذه الطريقة على إعداد كائن مدير الخدمة.
lookup(uint64_t aServiceEp, HostPortList *outHostPortList)
تبحث هذه الطريقة عن معلومات الدليل لنقطة نهاية الخدمة.
lookup(uint64_t aServiceEp, uint8_t *aControlByte, uint8_t **aDirectoryEntry)
تبحث هذه الطريقة عن معلومات الدليل لنقطة نهاية الخدمة.
onConnectionClosed(WEAVE_ERROR aError)
void
تتعامل هذه الطريقة مع حدث الاتصال المغلق الذي تم الإبلاغ عنه من خلال سياق تبادل Weave المرتبط.
onConnectionComplete(WEAVE_ERROR aError)
void
تعالج هذه الطريقة حدث الاتصال المكتمل الخاص بمعاملة طلب بحث نقطة نهاية الخدمة.
onResponseReceived(uint32_t aProfileId, uint8_t aMsgType, PacketBuffer *aMsg)
void
تتعامل هذه الطريقة مع أي رسالة رد في المحادثة باستخدام خدمة الدليل.
onResponseTimeout(void)
void
تتعامل هذه الطريقة مع حدث المهلة، الذي لم يتم تلقي أي رد من خدمة الدليل فيه.
relocate(WEAVE_ERROR aError)
void
تنقل هذه الطريقة ذاكرة التخزين المؤقت لدليل الخدمة.
relocate(void)
void
تنقل هذه الطريقة ذاكرة التخزين المؤقت لدليل الخدمة.
replaceOrAddCacheEntry(uint16_t port, const char *hostName, uint8_t hostLen, uint64_t serviceEndpointId)
أضِف إدخال دليل إلغاء اسم المضيف ومعرّف المنفذ في بداية قائمة الأدلة.
reset(WEAVE_ERROR aError)
void
تؤدي هذه الطريقة إلى إعادة ضبط مدير الخدمة على حالته الأولية.
reset(void)
void
تؤدي هذه الطريقة إلى إعادة ضبط مدير الخدمة على حالته الأولية.
unresolve(WEAVE_ERROR aError)
void
تؤدي هذه الطريقة إلى إلغاء صلاحية ذاكرة التخزين المؤقت لدليل الخدمة.
unresolve(void)
void
تؤدي هذه الطريقة إلى إلغاء صلاحية ذاكرة التخزين المؤقت لدليل الخدمة.

صفوف
nl::Weave::Profiles::ServiceDirectory::WeaveServiceManager::ConnectRequest

تمثّل هذه الفئة معاملة واحدة يديرها مدير الخدمة.

الأنواع العامة

@303

 @303
أماكن إقامة
kWeave_DefaultSendTimeout

عدد المللي ثانية التي يجب تلقّي استجابة لطلب بحث الدليل قبل انتهاء مهلة سياق التبادل.

OnConnectBegin

void(* OnConnectBegin)(struct ServiceConnectBeginArgs &args)

استدعاء تطبيق يتم إجراؤه قبل إنشاء الاتصال مباشرةً.

يمكن للتطبيقات استخدام استدعاء هذا الإجراء لمراقبة الوسيطات التي تم تمريرها إلى #WeaveConnection::Connect() أو تغييرها بشكل اختياري أثناء عملية إنشاء اتصال الخدمة. سيتم طلب معاودة الاتصال هذه لكل من الاتصال بنقطة نهاية الخدمة المستهدفة، بالإضافة إلى الاتصال بنقطة نهاية "دليل الخدمات" في حال ضرورة إجراء البحث عن دليل.

OnServiceEndpointQueryBegin

void(* OnServiceEndpointQueryBegin)(void)

استدعاء تطبيق لتحديد وقت طلب بحث دليل خدمة صادر.

ويُطلَق على ذلك عندما نكون على وشك إرسال طلب طلب بحث نقطة نهاية الخدمة. وتُستخدم هذه المطابقة للمطابقة مع OnServiceEndpointQueryEnd لتعويض وقت رحلة الرسالة.

OnServiceEndpointQueryEndWithTimeInfo

void(* OnServiceEndpointQueryEndWithTimeInfo)(uint64_t timeQueryReceiptMsec, uint32_t timeProcessMsec)

استدعاء تطبيق لتقديم قيم الوقت من رد دليل الخدمة.

ويستدعي ذلك عندما نحصل على معلومات الوقت من الرد على طلب بحث دليل الخدمة. لاحظ أن معاودة الاتصال لن تحدث إلا إذا تم تحليل الرد بنجاح وتضمين معلومات الوقت

التفاصيل
المعلمات
[in] timeQueryReceiptMsec
عدد وحدات المللي ثانية منذ تاريخ POSIX، عندما تم تلقّي طلب البحث من جهة الخادم.
[in] timeProcessMsec
عدد وحدات المللي ثانية التي تم إنفاقها على معالجة هذا الطلب

RootDirectoryAccessor

WEAVE_ERROR(* RootDirectoryAccessor)(uint8_t *aDirectory, uint16_t aLength)

دالة موصّل لمعلومات الدليل الجذر.

يجب أن تبدأ في مكان ما وباستخدام دليل الخدمة، يجب أن تبدأ بدليل بديل يحتوي على عنوان خادم يمكنك الوصول إليه في أي شيء آخر. وبما أنّه من المحتمل أن يختلف تصريف هذه المعلومات وأصلها من جهاز إلى آخر، نوفّر هنا إمكانية معاودة الاتصال بهذه المعلومات.

التفاصيل
المعلمات
[out] aDirectory
يشير إلى المخزن المؤقت لكتابة معلومات الدليل.
[in] aLength
طول المخزن المؤقت المحدد بالبايت.
المرتجعات
WEAVE_NO_ERROR عند نجاح الإجراء، وإلا سيتم إلغاء عملية التحميل.

StatusHandler

void(* StatusHandler)(void *anAppState, WEAVE_ERROR anError, StatusReport *aStatusReport)

يشير ذلك المصطلح إلى معالج لشروط الحالة والأخطاء.

قد يتم إبلاغ مستخدم مدير الخدمة بالمشكلات التي تحدث في محاولة تنفيذ طلب الاتصال بإحدى طريقتين. قد يتلقى الجهاز تقرير حالة من الخدمة أو قد يتلقى رسالة WEAVE_ERROR تم إنشاؤها داخليًا. وفي كلتا الحالتين، تأتي المعلومات من خلال معاودة الاتصال هذه.

التفاصيل
المعلمات
[in] anAppState
يشير ذلك المصطلح إلى مؤشر إلى كائن تطبيق تم تمريره إلى استدعاء conect() المقابل.
[in] anError
رمز خطأ Weave يشير إلى حدوث خطأ أثناء محاولة تنفيذ طلب الاتصال. وستكون هذه القيمة هي WEAVE_NO_ERROR في حال عدم حدوث أي خطأ وتوفّر تقرير الحالة.
[in] aStatusReport
مؤشر لتقرير الحالة الذي تم إنشاؤه بواسطة خدمة الدليل البعيد. يجب أن تكون هذه الوسيطة فارغة في حالة عدم وجود تقرير حالة وتم تمرير خطأ داخلي في الوسيطة السابقة.

وظائف عامة

SetConnectBeginCallback

void SetConnectBeginCallback(
  OnConnectBegin aConnectBegin
)

إعداد دالة رد الاتصال التي سيتم طلبها قبل إنشاء الاتصال مباشرةً.

التفاصيل
المعلمات
[in] aConnectBegin
يشير هذا المصطلح إلى مؤشر يؤدي إلى دالة رد الاتصال. تؤدي القيمة NULL إلى إيقاف معاودة الاتصال.

WeaveServiceManager

 WeaveServiceManager(
  void
)

تعمل هذه الطريقة على إعداد مثيل WeaveServiceManager.

تجدر الإشارة إلى ضرورة استدعاء init() لإعداد هذا المثيل بشكل أكبر.

إلغاء

void cancel(
  uint64_t aServiceEp,
  void *aAppState
)

تؤدي هذه الطريقة إلى إلغاء طلب الربط.

تؤدي هذه الطريقة إلى إلغاء طلب الاتصال نظرًا لمعرّف نقطة نهاية الخدمة وعنصر حالة التطبيق الذي تم تمريره في وقت الطلب كمعرّفات. إذا كان هذا هو طلب الربط الأخير، فإن هذه الطريقة تزيل أي حالة اتصال في دليل الخدمة في انتظار المراجعة أيضًا.

التفاصيل
المعلمات
[in] aServiceEp
رقم تعريف نقطة نهاية الخدمة للطلب الذي يتم إلغاؤه.
[in] anAppState
يشير إلى عنصر حالة التطبيق المحدَّد لاستدعاء connect().

clearCache

void clearCache(
  void
)

تمحو هذه الطريقة حالة المدير وذاكرة التخزين المؤقت فيه إذا كانت الحالة في الوحدة الطرفية kServiceMgrState_solutionsd، ما يعني أنه تم تلقّي الاستجابة من نقطة نهاية "دليل الخدمة".

اتصل

WEAVE_ERROR connect(
  uint64_t aServiceEp,
  WeaveAuthMode aAuthMode,
  void *aAppState,
  StatusHandler aStatusHandler,
  WeaveConnection::ConnectionCompleteFunct aConnectionCompleteHandler,
  const uint32_t aConnectTimeoutMsecs,
  const InterfaceId aConnectIntf
)

تطلب هذه الطريقة الاتصال بخدمة Weave.

هذه هي مكالمة التواصل ذات المستوى الأعلى. وهو يوفر في الأساس اتصالاً آمنًا بخدمة Weave بناءً على نقطة نهاية الخدمة ووضع المصادقة أو الموت أثناء المحاولة.

لا يمكن استدعاء هذه الطريقة إلا بعد نجاح استدعاء الدالة init()، ويمكن إلغاء طلب الاتصال عن طريق cancel().

يمكن استدعاء هذه الطريقة قبل ملء ذاكرة التخزين المؤقت المحلية ببيانات من البيانات المتوفرة تلقائيًا أو من رحلة إلى خدمة الدليل. سيضيف مدير الخدمة الطلب إلى قائمة الانتظار قبل التمكّن من تحديد محتوى ذاكرة التخزين المؤقت.

التفاصيل
المعلمات
[in] aServiceEp
معرّف نقطة نهاية الخدمة، كما هو محدّد في ServiceDirectory.h، للخدمة المعنيّة.
[in] aAuthMode
وضع المصادقة المستخدَم عند الاتصال بالخدمة ذات الاهتمام
[in] aAppState
مؤشر إلى كائن حالة التطبيق، يتم تمريره إلى عمليات الاستدعاء كوسيطة.
[in] aStatusHandler
يشير ذلك المصطلح إلى معاودة الاتصال ليتم استدعاءها في حال حدوث خطأ قبل اكتمال الاتصال.
[in] aConnectionCompleteHandler
يشير هذا المصطلح إلى معاودة الاتصال لاستدعاءها في حال اكتمال عملية الربط المطلوبة. لاحظ أن الاتصال قد يفشل مع رمز خطأ Weave.
[in] aConnectTimeoutMsecs
مهلة اتصال TCP الاختيارية بالملي ثانية.
[in] aConnectIntf
الواجهة الاختيارية التي سيتم إنشاء الاتصال عليها.
المرتجعات
WEAVE_NO_ERROR بشأن النجاح؛ بخلاف ذلك، رمز خطأ ذي صلة.

إعداد

WEAVE_ERROR init(
  WeaveExchangeManager *aExchangeMgr,
  uint8_t *aCache,
  uint16_t aCacheLen,
  RootDirectoryAccessor aAccessor,
  WeaveAuthMode aDirAuthMode,
  OnServiceEndpointQueryBegin aServiceEndpointQueryBegin,
  OnServiceEndpointQueryEndWithTimeInfo aServiceEndpointQueryEndWithTimeInfo,
  OnConnectBegin aConnectBegin
)

تعمل هذه الطريقة على إعداد كائن مدير الخدمة.

من أجل استخدام عنصر مدير الخدمة، يجب إعداد كائن مدير الخدمة. بعد استدعاء هذه الطريقة بنجاح، يمكن للعملاء البدء في استدعاء connect() وlookup() وطرق أخرى.

التفاصيل
المعلمات
[in] aExchangeMgr
مؤشر يشير إلى مدير التبادل لاستخدامه في جميع عمليات تبادل الملف الشخصي لدليل الخدمة.
[in] aCache
يشير هذا المصطلح إلى مؤشر للمخزن المؤقت الذي يمكن استخدامه لتخزين معلومات الدليل مؤقتًا.
[in] aCacheLen
الطول بالبايت في ذاكرة التخزين المؤقت.
[in] aAccessor
يشير هذا المصطلح إلى طلب الاستدعاء، كما هو محدَّد في ServiceDirectory.h الذي يجب استدعاؤه لتحميل الدليل الجذري كنقطة بداية للبحث عن الدليل.
[in] aDirAuthMode
وضع المصادقة المستخدَم عند الاتصال بخدمة الدليل.
[in] aServiceEndpointQueryBegin
يشير ذلك المصطلح إلى مؤشر وظائف من النوع OnServiceEndpointQueryges، ويتم استدعاؤه في بداية طلب دليل الخدمة، ويسمح لرمز التطبيق بتحديد الوقت إذا كان يريد استخدام مزامنة الوقت التي يوفّرها بروتوكول دليل الخدمة.
[in] aServiceEndpointQueryEndWithTimeInfo
مؤشر وظائف من النوع OnServiceEndpointQueryEndWithTimeInfo، يتم استدعاؤه عند استلام دليل خدمة يسمح للتطبيقات بالمزامنة مع خدمة Weave باستخدام حقول الوقت الواردة في الاستجابة. سيتم إجراء معاودة الاتصال هذه بعد أن يتلقّى مدير الخدمة ردًا يتضمّن معلومات الوقت. يجب ملء ذاكرة التخزين المؤقت بنجاح قبل إجراء معاودة الاتصال.
[in] aConnectBegin
مؤشر دالة من النوع OnConnectStart، يتم استدعاؤه قبل إنشاء الاتصال مباشرةً ويسمح للتطبيقات بمراقبة الوسيطات التي تم تمريرها إلى #WeaveConnection::Connect() وتعديل هذه الوسيطات بشكل اختياري. تؤدي القيمة NULL (الافتراضية) إلى إيقاف معاودة الاتصال.
المرتجعات
WEAVE_ERROR_INVALID_ARGUMENT إذا كانت وسيطة الدالة غير صالحة، بخلاف ذلك، WEAVE_NO_ERROR.

البحث

WEAVE_ERROR lookup(
  uint64_t aServiceEp,
  HostPortList *outHostPortList
)

تبحث هذه الطريقة عن معلومات الدليل لنقطة نهاية الخدمة.

إذا تم حلّ مشكلة دليل الخدمة، أي في حال إجراء عملية connect() بنجاح، ستتم هذه الطريقة تعبئة الكائن HostPortList المقدَّم.

ملاحظة: يتمّ ربط HostPortList بالكائن WeaveServiceManager. يظل صالحًا حتى يتم محو ذاكرة التخزين المؤقت لدليل الخدمة أو حتى يتم البحث عن دليل خدمة آخر.

التفاصيل
المعلمات
[in] aServiceEp
معرِّف نقطة نهاية الخدمة المطلوب البحث عنها.
[out] outHostPortList
المؤشر المؤدي إلى HostPortList الذي ستتم تعبئته عند البحث الناجح عن إدخال الدليل. يجب ألا تكون فارغة (NULL).
قيم الإرجاع
WEAVE_NO_ERROR
على النجاح؛ بخلاف ذلك، رمز خطأ ذي صلة.
WEAVE_ERROR_INVALID_SERVICE_EP
في حال عدم العثور على نقطة نهاية الخدمة المحدّدة.
WEAVE_ERROR_INVALID_DIRECTORY_ENTRY_TYPE
إذا كان الدليل يحتوي على نوع إدخال دليل غير معروف.

البحث

WEAVE_ERROR lookup(
  uint64_t aServiceEp,
  uint8_t *aControlByte,
  uint8_t **aDirectoryEntry
)

تبحث هذه الطريقة عن معلومات الدليل لنقطة نهاية الخدمة.

إذا تم حلّ دليل الخدمة، أي إذا كانت هناك عملية connect() ناجحة، ستعرض هذه الطريقة إدخال دليل وفقًا لمعرّف نقطة نهاية الخدمة.

تكشف هذه الطريقة عن تفاصيل التنفيذ الداخلي لدليل الخدمة، ويجب أن تفضِّل عمليات التنفيذ بشدة استخدام صيغة هذه الطريقة التي تنشئ HostPortList.

التفاصيل
المعلمات
[in] aServiceEp
معرِّف نقطة نهاية الخدمة المطلوب البحث عنها.
[out] aControlByte
إشارة إلى المكان المخصص لكتابة بايت عنصر التحكم في إدخال الدليل.
[out] aDirectoryEntry
يشير هذا المصطلح إلى مؤشر الماوس الذي سيتم توجيهه إلى إدخال الدليل.
قيم الإرجاع
WEAVE_NO_ERROR
على النجاح؛ بخلاف ذلك، رمز خطأ ذي صلة.
WEAVE_ERROR_INVALID_SERVICE_EP
في حال عدم العثور على نقطة نهاية الخدمة المحدّدة.
WEAVE_ERROR_INVALID_DIRECTORY_ENTRY_TYPE
إذا كان الدليل يحتوي على نوع إدخال دليل غير معروف.

onConnectionClosed

void onConnectionClosed(
  WEAVE_ERROR aError
)

تتعامل هذه الطريقة مع حدث الاتصال المغلق الذي تم الإبلاغ عنه من خلال سياق تبادل Weave المرتبط.

التفاصيل
المعلمات
[in] aError
حدث خطأ في Weave يشير إلى سبب إغلاق هذا الاتصال.

onConnectionComplete

void onConnectionComplete(
  WEAVE_ERROR aError
)

تعالج هذه الطريقة حدث الاتصال المكتمل الخاص بمعاملة طلب بحث نقطة نهاية الخدمة.

هناك احتمالان. أولاً، ربما فشل الاتصال وفي هذه الحالة نكون قد انتهينا. وإلا، يكون الاتصال قد اكتمل فعلاً وما نريد القيام به هو فتح سياق تبادل وإرسال استعلام دليل.

التفاصيل
المعلمات
[in] aError
يحدث خطأ Weave في حال حدوث أي خطأ أثناء إعداد الاتصال.

onResponseReceived

void onResponseReceived(
  uint32_t aProfileId,
  uint8_t aMsgType,
  PacketBuffer *aMsg
)

تتعامل هذه الطريقة مع أي رسالة رد في المحادثة باستخدام خدمة الدليل.

التفاصيل
المعلمات
[in] aProfileId
معرِّف الملف الشخصي لهذه الرسالة الواردة.
[in] aMsgType
النوع الخاص بالملف الشخصي لهذه الرسالة.
[in] aMsg
محتوى هذه الرسالة.

onResponseTimeout

void onResponseTimeout(
  void
)

تتعامل هذه الطريقة مع حدث المهلة، الذي لم يتم تلقي أي رد من خدمة الدليل فيه.

نقل

void relocate(
  WEAVE_ERROR aError
)

تنقل هذه الطريقة ذاكرة التخزين المؤقت لدليل الخدمة.

عندما تعرض نقطة نهاية خدمة تقرير حالة برمز الحالة kStatus_Replacement، يمكن للتطبيق استدعاء unresolve() لمحو ذاكرة التخزين المؤقت وإلغاء طلبات الاتصال. تعمل هذه الطريقة على تبسيط معالجة الأخطاء من خلال استدعاء unresolve() في المرة الأولى وreset() إذا لم يتم حلّ المشكلة بعد.

هذا الإصدار من الطريقة - هنا للتوافق مع الأنظمة القديمة - يتخذ خطأً ويسجله ثم يستدعي relocate(void) .

التفاصيل
المعلمات
[in] aError
خطأ للتسجيل.
يُرجى الاطّلاع أيضًا على:
relocate(void)

نقل

void relocate(
  void
)

تنقل هذه الطريقة ذاكرة التخزين المؤقت لدليل الخدمة.

عندما تعرض نقطة نهاية خدمة تقرير حالة برمز الحالة kStatus_Replacement، يمكن للتطبيق استدعاء unresolve() لمحو ذاكرة التخزين المؤقت وإلغاء طلبات الاتصال. تعمل هذه الطريقة على تبسيط معالجة الأخطاء من خلال استدعاء unresolve() في المرة الأولى وreset() إذا لم يتم حلّ المشكلة بعد.

يُرجى الاطّلاع أيضًا على:
إعادة تحديد(WEAVE_ERROR)

replaceOrAddCacheEntry

WEAVE_ERROR replaceOrAddCacheEntry(
  uint16_t port,
  const char *hostName,
  uint8_t hostLen,
  uint64_t serviceEndpointId
)

أضِف إدخال دليل إلغاء اسم المضيف ومعرّف المنفذ في بداية قائمة الأدلة.

إعادة ضبط

void reset(
  WEAVE_ERROR aError
)

تؤدي هذه الطريقة إلى إعادة ضبط مدير الخدمة على حالته الأولية.

تؤدي هذه الطريقة إلى إعادة ضبط جميع حالات مدير الخدمة، بما في ذلك حالة الاتصالات وحالة ذاكرة التخزين المؤقت وحالة أي طلبات ربط معلّقة.

هذا الإصدار من الطريقة - هنا للتوافق مع الأنظمة القديمة - يتخذ خطأً ويسجله ثم يستدعي reset(null) .

التفاصيل
المعلمات
[in] aError
الخطأ الذي أدّى إلى تنفيذ هذه العملية.
يُرجى الاطّلاع أيضًا على:
إعادة ضبط(غير)

إعادة ضبط

void reset(
  void
)

تؤدي هذه الطريقة إلى إعادة ضبط مدير الخدمة على حالته الأولية.

تؤدي هذه الطريقة إلى إعادة ضبط جميع حالات مدير الخدمة، بما في ذلك حالة الاتصالات وحالة ذاكرة التخزين المؤقت وحالة أي طلبات ربط في انتظار المراجعة.

يُرجى الاطّلاع أيضًا على:
إعادة ضبط(WEAVE_ERROR)

لم يتم الحل

void unresolve(
  WEAVE_ERROR aError
)

تؤدي هذه الطريقة إلى إلغاء صلاحية ذاكرة التخزين المؤقت لدليل الخدمة.

تضبط هذه الطريقة حالة ذاكرة التخزين المؤقت لدليل الخدمة، بحيث يُصدر مدير الخدمة استعلامًا لدليل الخدمة عند الطلب التالي.

هذا الإصدار من الطريقة - هنا للتوافق مع الأنظمة القديمة - يأخذ خطأ ويسجلها ثم يستدعي unresolve(null) .

التفاصيل
المعلمات
[in] aError
الخطأ الذي أدّى إلى تنفيذ هذه العملية.
يُرجى الاطّلاع أيضًا على:
لم يتم حله(ملغى)

لم يتم الحل

void unresolve(
  void
)

تؤدي هذه الطريقة إلى إلغاء صلاحية ذاكرة التخزين المؤقت لدليل الخدمة.

تضبط هذه الطريقة حالة ذاكرة التخزين المؤقت لدليل الخدمة، بحيث يُصدر مدير الخدمة استعلامًا لدليل الخدمة عند الطلب التالي.

يُرجى الاطّلاع أيضًا على:
unresolve(WEAVE_ERROR)

~WeaveServiceManager

 ~WeaveServiceManager(
  void
)

تؤدي هذه الطريقة إلى إتلاف مثيل WeaveServiceManager.