دالة Offer [SWS_DM_01872] Upstream: RS_Diag_04261
ara::core::Result< void > Offer () noexcept;
This Offer will enable the DM to forward request messages to this handler.
الاستخدام
يُستخدم الأسلوب Offer للفئة ara::diag::SovdConfiguration لتفعيل توجيه طلبات التشخيص بواسطة Diagnostic Management (DM) إلى المعالج المكوّن [SWS_DM_01872]. يتم الاستدعاء بشكل متزامن، ولا يقبل أي معلمات، ويبلغ بالنتيجة عبر ara::core::Result<void> [SWS_DM_01872]. وما دام المعالج لم يُقدَّم عبر Offer، فلن يُوجّه DM أي طلبات واردة، وهو ما يتوافق مع نمط التقديم الأساسي لواجهات التشخيص (قارن [SWS_DM_01525]، [SWS_DM_00809]).
معالجة الأخطاء
في حالة الخطأ، يُرجع ara::core::Result مع كود خطأ من التعداد DiagOfferErrc، مع تطبيق دلالات التراجع (Rollback) [SWS_DM_01872]:
DiagOfferErrc::kAlreadyOffered: يتم الإبلاغ عنه إذا كانت الخدمة قد عُرضت بالفعل مسبقًا [SWS_DM_01872].DiagOfferErrc::kConfigurationMismatch: يحدث عندما لا يتطابق التكوين مع بيانات وصف DEXT [SWS_DM_01872].
التزامن والقيود
تم التصريح عن العملية كـ noexcept وهي آمنة من الاستثناءات (exception safe)، إلا أنها محددة كغير آمنة لخيوط المعالجة (not thread-safe) [SWS_DM_01872]. يجب منع الاستدعاءات المتزامنة لنفس المثيل من خيوط معالجة متعددة بواسطة التطبيق المستدعي. ويُرجح أن يُقابل تكرار الاستدعاء بعد تقديم الخدمة بالفعل بخطأ دون تغيير في الحالة. سؤال Q-f9b1a995dbb002ef (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR بالنسخة R25-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
| Header-Datei | #include "ara/diag/sovd_configuration.h" |
|---|---|
| Scope | class ara::diag::SovdConfiguration |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | not thread-safe |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Result< void > | Returns nothing or an error. |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| DiagOfferErrc::kConfigurationMismatch | rollback_semantics monitor configuration does not match DEXT |
| DiagOfferErrc::kAlreadyOffered | rollback_semantics The service is already offered. |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_DM_01872- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_DM_01872@rel:R25-11#986de9c0- Content hash
986de9c0- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01872
Status: valid/unmigrated
Version: rel:R25-11#3482e5bc
Versionshistorie & Revisions (1 transition, 4 revision)
- Current State
valid/unmigrated- Reason
- mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
- Campaign
2026-08-13-status-backfill- Active Version
AUTOSAR/AP/record/SWS_DM_01872@rel:R25-11#3482e5bc
Recorded Revisions (4):
- R25-11
rel:R25-11#017896392026-09-30 - R23-11
rel:R23-11#9fcae3412026-10-14 - R24-11
rel:R24-11#635634302026-10-14 - R25-11
rel:R25-11#3482e5bc2026-10-14 active
Requirement Text as-of this release:
Curation Decisions:
Reachable Artifacts & Dependents:
| Date | Actor | Transition | Reason / Rationale | Campaign |
|---|---|---|---|---|
| 2026-08-13 | tool | none → valid/unmigrated | mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record | 2026-08-13-status-backfill |
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني