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_resolved، ما يعني أنه تم استلام الاستجابة من نقطة نهاية دليل الخدمة.
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_resolved، ما يعني أنه تم استلام الاستجابة من نقطة نهاية دليل الخدمة.

اتصل

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 عند النجاح، وبخلاف ذلك، يتم عرض رمز خطأ ذي صلة.

init

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
مؤشر دالة من النوع OnServiceEndpointQueryStart، والذي يتم استدعاؤه في بداية طلب دليل الخدمة ويسمح لرمز التطبيق بتحديد الوقت إذا كان يريد استخدام مزامنة الوقت التي يوفّرها بروتوكول دليل الخدمة.
[in] aServiceEndpointQueryEndWithTimeInfo
مؤشر دالة من النوع OnServiceEndpointQueryEndTimeInfo، ويتم استدعاؤه عند استلام دليل خدمة يسمح للتطبيقات بالمزامنة مع خدمة 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 الذي ستتم تعبئته عند البحث الناجح عن إدخال الدليل. يجب ألا يكون فارغًا.
قيم الإرجاع
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_Relocation، قد يطلب التطبيق الأمر unresolve() لمحو ذاكرة التخزين المؤقت وإلغاء طلبات الاتصال. تعمل هذه الطريقة على تبسيط معالجة الأخطاء من خلال استدعاء unresolve() في أول مرة وreset() إذا لم يتم حل المشكلة بعد.

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

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

تغيير الموقع

void relocate(
  void
)

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

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

راجِع أيضًا:
relocate(WEAVE_ERROR)

replaceOrAddCacheEntry

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

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

إعادة ضبط

void reset(
  WEAVE_ERROR aError
)

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

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

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

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

إعادة ضبط

void reset(
  void
)

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

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

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

عدم الحل

void unresolve(
  WEAVE_ERROR aError
)

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

تحدد هذه الطريقة حالة ذاكرة التخزين المؤقت لدليل الخدمة بحيث يُصدر مدير الخدمة طلب بحث في دليل الخدمة في الطلب التالي.

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

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

عدم الحل

void unresolve(
  void
)

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

تحدد هذه الطريقة حالة ذاكرة التخزين المؤقت لدليل الخدمة بحيث يُصدر مدير الخدمة طلب بحث في دليل الخدمة في الطلب التالي.

راجِع أيضًا:
unresolve(WEAVE_ERROR)

~WeaveServiceManager

 ~WeaveServiceManager(
  void
)

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