nl::Weave::Support

ملخّص

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

المتغيرات
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::Support::ProfileStringContext

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

nl::Weave::Support::ProfileStringInfo

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

تحديدات النوع

MessageNameFunct

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

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

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

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

ProfileNameFunct

const char *(* ProfileNameFunct)(uint32_t inProfileId)

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

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

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

StatusReportFormatStringFunct

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

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

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

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

المتغيرات

sProfileStringContextHead

ProfileStringContext * sProfileStringContextHead

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

الدوال

FindProfileStringContext

ProfileStringContext * FindProfileStringContext(
  const ProfileStringContext & inContext
)

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

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

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

FindProfileStringInfo

NL_DLL_EXPORT const ProfileStringInfo * FindProfileStringInfo(
  uint32_t inProfileId
)

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

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

InsertProfileStringContext

bool InsertProfileStringContext(
  ProfileStringContext & inOutContext
)

أدرِج سياق دعم سلسلة الملف الشخصي المحدّد في قاعدة بيانات المسجّلين.

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

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

RegisterProfileStringInfo

NL_DLL_EXPORT WEAVE_ERROR RegisterProfileStringInfo(
  ProfileStringContext & inOutContext
)

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

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

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

RemoveProfileStringContext

bool RemoveProfileStringContext(
  ProfileStringContext & inOutContext
)

أزِل سياق دعم سلسلة الملف الشخصي المحدّد من قاعدة بيانات المسجّلين.

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

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

UnregisterProfileStringInfo

NL_DLL_EXPORT WEAVE_ERROR UnregisterProfileStringInfo(
  ProfileStringContext & inOutContext
)

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

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

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