دالة Offer [SWS_DM_01969] Upstream: RS_Diag_04251
ara::core::Result< void > Offer () noexcept;
This Offer will enable the DM to forward request messages to this handler.
من خلال الطريقة Offer، يفعّل تطبيق Adaptive Application إعادة توجيه طلبات التشخيص بواسطة Diagnostic Management (DM) إلى المعالج المختص من الفئة ara::diag::TransmitCertificate [SWS_DM_01969]. يتم الاستدعاء بشكل متزامن وبدون معلمات؛ والواجهة معرّفة بأنها آمنة من حيث الاستثناءات (noexcept) [SWS_DM_01969]. يُستخدم ara::core::Result<void> كنوع إرجاع، والذي ينقل نجاح التسجيل أو حالة خطأ إلى المتصل [SWS_DM_01969].
إذا تم استدعاء الدالة مسبقًا لنسخة المعالج المعنية، فإن الاستدعاء الجديد يفشل ويعيد الخطأ المحدد DiagOfferErrc::kAlreadyOffered بدلالات التراجع (rollback) [SWS_DM_01969]، والذي يطابق قيمة الخطأ القياسية في DiagErrc [SWS_DM_00514]. ونظرًا لأن الدالة محددة صراحة بأنها ليست آمنة تفرعيًا [SWS_DM_01969]، فيجب تجنب عمليات الوصول المتوازية على نفس النسخة (تفسير: تقع الحماية من الاستدعاءات المتزامنة على عاتق البرنامج المستخدم). سؤال Q-b44b11a0a2dcb2b4 (مفتوح)
يتبع نمط تشغيل Offer المفهوم الموحد لتوفير معالجات التشخيص، كما هو مطبق أيضًا مع ara::diag::Authentication::Offer [SWS_DM_01130]، أو ara::diag::CommunicationControl::Offer [SWS_DM_00809]، أو ara::diag::GenericRoutine::Offer [SWS_DM_00557]. توضح AUTOSAR أنه على الرغم من التشابه في التسمية مع ara::com، إلا أن هناك تنفيذ تشخيص مستقل (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»). قبل التوفير عبر Offer، لا يعيد الـ DM توجيه أي طلبات إلى المعالج، بشكل مشابه لخدمات DoIP التي تُعتبر غير جاهزة قبل الاستدعاء [SWS_DM_01525].
تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند إلى مواصفات الإصدار R25-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
| Header-Datei | #include "ara/diag/transmit_certificate.h" |
|---|---|
| Scope | class ara::diag::TransmitCertificate |
| 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::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_01969- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_DM_01969@rel:R25-11#fb140ab1- Content hash
fb140ab1- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01969
Status: valid/unmigrated
Version: rel:R25-11#b76c9464
Versionshistorie & Revisions (1 transition, 3 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_01969@rel:R25-11#b76c9464
Recorded Revisions (3):
- R25-11
rel:R25-11#3e7453c82026-09-30 - R24-11
rel:R24-11#bec87af22026-10-14 - R25-11
rel:R25-11#b76c94642026-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 · الأصل الألماني