nl::Weave::الدعم

الملخّص

رفوف النوع

MessageNameFunct)(uint32_t inProfileId, uint8_t inMsgType) typedef
const char *(*
Typedef لدالة معاودة اتصال تعرض سلسلة C محملة بـ NULL يمكن قراءتها بواسطة شخص يصف نوع الرسالة المرتبط بمعرف الملف الشخصي المحدد.
ProfileNameFunct)(uint32_t inProfileId) typedef
const char *(*
Typedef لدالة معاودة اتصال تعرض سلسلة C-منتهية في حقل NULL يمكن للمستخدمين قراءتها والتي تصف الملف الشخصي الذي يتضمن معرِّف الملف الشخصي المحدّد.
StatusReportFormatStringFunct)(uint32_t inProfileId, uint16_t inStatusCode) typedef
const char *(*
Typedef لدالة معاودة اتصال تعرض سلسلة C-ملغاة بواسطة NULL يمكن للمستخدمين قراءتها وتصف رمز الحالة المرتبط بمعرّف الملف الشخصي المحدد.

المتغيّرات

sProfileStringContextHead
مؤشّر رأس القائمة المرتبط بشكل فردي في السجلّ.

الدوال

FindProfileStringContext(const ProfileStringContext & inContext)
يمكنك البحث عن سياق دعم سلسلة للملف الشخصي يتطابق مع السياق المحدَّد استنادًا إلى معرّف الملف الشخصي المرتبط بالسياق.
FindProfileStringInfo(uint32_t inProfileId)
NL_DLL_EXPORT const ProfileStringInfo *
ابحث عن سلسلة الملف الشخصي، إنْ كانت مسجَّلة، مع استدعاءات المكالمات المرتبطة بمعرّف الملف الشخصي المحدّد.
InsertProfileStringContext(ProfileStringContext & inOutContext)
bool
يمكنك إدراج سياق دعم سلسلة الملف الشخصي المُحدَّد في السجلّ.
RegisterProfileStringInfo(ProfileStringContext & inOutContext)
NL_DLL_EXPORT WEAVE_ERROR
يمكنك تسجيل استدعاءات دعم سلسلة الملف الشخصي المقدَّمة.
RemoveProfileStringContext(ProfileStringContext & inOutContext)
bool
إزالة سياق دعم سلسلة الملف الشخصي المُحدَّد من السجلّ.
UnregisterProfileStringInfo(ProfileStringContext & inOutContext)
NL_DLL_EXPORT WEAVE_ERROR
ألغِ تسجيل عمليات معاودة الاتصال لسلسلة الملف الشخصي المقدَّمة.

الهياكل

nl::Weave::الدعم::ProfileStringContext

سياق لتسجيل وإلغاء استدعاءات الاستدعاء المرتبطة بمعرّف الملف الشخصي المحدّد لإرجاع سلاسل الدعم التي يمكن للمستخدمين قراءتها ومرتبطة بالملف الشخصي.

nl::Weave::الدعم::ProfileStringInfo

طلبات معاودة الاتصال المرتبطة بمعرّف الملف الشخصي المحدّد لإرجاع سلاسل الدعم التي يمكن للمستخدمين قراءتها والمرتبطة بالملف الشخصي.

رفوف النوع

رسالة اسم الرسالة

const char *(* MessageNameFunct)(uint32_t inProfileId, uint8_t inMsgType)

Typedef لدالة معاودة اتصال تعرض سلسلة C محملة بـ NULL يمكن قراءتها بواسطة شخص يصف نوع الرسالة المرتبط بمعرف الملف الشخصي المحدد.

يتم استدعاء رد الاتصال هذا، عند التسجيل، عندما تكون هناك سلسلة C إنهاءها بلغة NULL يمكن للمستخدمين قراءتها لوصف نوع الرسالة المرتبط بمعرّف الملف الشخصي المحدد.

التفاصيل
المعلَمات
[in] inProfileId
معرّف الملف الشخصي المرتبط بنوع الرسالة المحدد
[in] inMsgType
نوع الرسالة المطلوب سلسلة وصفية يسهل على الإنسان قراءتها
المرتجعات
مؤشر إلى السلسلة C-terminated C في حال العثور على مطابقة، وبخلاف ذلك، NULL.

نمط الملف الشخصي

const char *(* ProfileNameFunct)(uint32_t inProfileId)

Typedef لدالة معاودة اتصال تعرض سلسلة C-منتهية في حقل NULL يمكن للمستخدمين قراءتها والتي تصف الملف الشخصي الذي يتضمن معرِّف الملف الشخصي المحدّد.

يتم استدعاء هذه المكالمة عند التسجيل عندما تكون هناك حاجة إلى سلسلة C محمَّلة بواسطة NULL-يمكن للمستخدم قراءتها.

التفاصيل
المعلَمات
[in] inProfileId
معرّف الملف الشخصي الذي يتم البحث عن سلسلة وصفية يمكنه قراءتها.
المرتجعات
مؤشر إلى السلسلة C-terminated C في حال العثور على مطابقة، وبخلاف ذلك، NULL.

حالة تنسيق السلسلة

const char *(* StatusReportFormatStringFunct)(uint32_t inProfileId, uint16_t inStatusCode)

Typedef لدالة معاودة اتصال تعرض سلسلة C-ملغاة بواسطة NULL يمكن للمستخدمين قراءتها وتصف رمز الحالة المرتبط بمعرّف الملف الشخصي المحدد.

يتم استدعاء هذه الدالة، عند تسجيلها، عندما تكون هناك سلسلة C محمَّلة بواسطة NULL يمكن قراءتها بواسطة الإنسان لوصف رمز الحالة المرتبط بمعرّف الملف الشخصي المحدد.

التفاصيل
المعلَمات
[in] inProfileId
معرّف الملف الشخصي المرتبط برمز الحالة المحدّد.
[in] inStatusCode
رمز الحالة الذي يُطلب منه سلسلة وصفية يمكن للمستخدمين قراءتها.
المرتجعات
مؤشر إلى السلسلة C-terminated C في حال العثور على مطابقة، وبخلاف ذلك، NULL.

المتغيّرات

sProfileStringContextHead

ProfileStringContext * sProfileStringContextHead

مؤشّر رأس القائمة المرتبط بشكل فردي في السجلّ.

الدوال

سياق سلسلة الملفات الشخصية

ProfileStringContext * FindProfileStringContext(
  const ProfileStringContext & inContext
)

يمكنك البحث عن سياق دعم سلسلة للملف الشخصي يتطابق مع السياق المحدَّد استنادًا إلى معرّف الملف الشخصي المرتبط بالسياق.

تبحث هذه الدالة عن سياق دعم سلسلة للملف الشخصي يتطابق مع السياق المحدّد، استنادًا إلى معرّف الملف الشخصي المرتبط بالسياق.

التفاصيل
المعلَمات
[in] inContext
مرجع للقراءة فقط يتعلّق بسياق دعم سلسلة الملف الشخصي للعثور عليه.
المرتجعات
مؤشر للقراءة فقط إلى سياق دعم سلسلة الملف الشخصي إذا تم العثور عليه، بخلاف ذلك، NULL.

العثور على معلومات الملف الشخصي

NL_DLL_EXPORT const ProfileStringInfo * FindProfileStringInfo(
  uint32_t inProfileId
)

ابحث عن سلسلة الملف الشخصي، إنْ كانت مسجَّلة، مع استدعاءات المكالمات المرتبطة بمعرّف الملف الشخصي المحدّد.

التفاصيل
المعلَمات
[in] inProfileId
رقم تعريف الملف الشخصي للعثور على استدعاءات دعم السلسلة.
المرتجعات
مؤشر للقراءة فقط إلى سلسلة الملف الشخصي يدعم عمليات معاودة الاتصال إذا تم العثور عليها، وإلا، NULL.
يُرجى أيضًا الاطّلاع على:
RegisterProfielStringInfo
UnregisterProfielStringInfo

InsertProfileStringContext

bool InsertProfileStringContext(
  ProfileStringContext & inOutContext
)

يمكنك إدراج سياق دعم سلسلة الملف الشخصي المُحدَّد في السجلّ.

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

التفاصيل
المعلَمات
[in,out] inOutContext
مرجع إلى سياق دعم سلسلة الملف الشخصي الذي سيتم إدراجه في قاعدة بيانات المسجّلين. على الرغم من وجود السياق في السجلّ، يمكن تعديل حقل mNext عند إدراج سياقات أخرى أو إزالتها.
المرتجعات
صحيح إذا تم إدراج السياق، وإلا سيتم خطأ.

معلومات الملف الشخصي للسلسلة

NL_DLL_EXPORT WEAVE_ERROR RegisterProfileStringInfo(
  ProfileStringContext & inOutContext
)

يمكنك تسجيل استدعاءات دعم سلسلة الملف الشخصي المقدَّمة.

تسجّل هذه الدالة استدعاءات سلسلة الملف الشخصي المقدّمة وتوفّرها.

التفاصيل
المعلَمات
[in,out] inOutContext
مرجع إلى سياق دعم سلسلة الملف الشخصي سيتم تسجيله وإضافته إلى قاعدة بيانات المسجّلين. أثناء تسجيل السياق، قد يتم تعديل حقل mNext حيث يتم تسجيل سياقات أخرى أو إلغاء تسجيلها.
قيم الإرجاع
WEAVE_NO_ERROR
النجاح.
WEAVE_ERROR_PROFILE_STRING_CONTEXT_ALREADY_REGISTERED
إذا كان السياق مسجّلاً
يُرجى الاطّلاع أيضًا على:
FindStringProfileInfo
UnregisterProfielStringInfo

إزالة الملف الشخصي للسلسلة

bool RemoveProfileStringContext(
  ProfileStringContext & inOutContext
)

إزالة سياق دعم سلسلة الملف الشخصي المُحدَّد من السجلّ.

تزيل هذه الدالة سياق دعم سلسلة الملف الشخصي المحدّد من السجلّ، في حال توفّره، استنادًا إلى معرّف الملف الشخصي.

التفاصيل
المعلَمات
[in,out] inOutContext
مرجع إلى سياق دعم سلسلة الملف الشخصي الذي ستتم إزالته، إن توفّر. وعند إزالة السياق، قد يتم تعديل حقل mNext.
المرتجعات
صحيح إذا تمت إزالة السياق، وبخلاف ذلك، يكون خاطئًا.

إلغاء تسجيل الملف الشخصي

NL_DLL_EXPORT WEAVE_ERROR UnregisterProfileStringInfo(
  ProfileStringContext & inOutContext
)

ألغِ تسجيل عمليات معاودة الاتصال لسلسلة الملف الشخصي المقدَّمة.

تعمل هذه الدالة على إلغاء تسجيل واستدعاءات دعم سلسلة الملف الشخصي المقدّمة، وهي غير متاحة.

التفاصيل
المعلَمات
[in,out] inOutContext
مرجع إلى سياق دعم سلسلة الملفات الشخصية سيتم إلغاء تسجيله في حال تسجيله وإزالته من السجلّ. عندما يتم إلغاء تسجيل السياق، قد يتم تعديل حقل mNext.
قيم الإرجاع
WEAVE_NO_ERROR
النجاح.
WEAVE_ERROR_PROFILE_STRING_CONTEXT_NOT_REGISTERED
وفي حال لم يكن السياق مسجَّلاً
يُرجى الاطّلاع أيضًا على:
FindStringProfileInfo
RegisterProfielStringInfo