دالة Create [SWS_CM_10438] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139
static ara::core::Result< <SI>Proxy > Create (const <SI-Namespace>::proxy:: <SI>Proxy::HandleType &handle) noexcept;
Exception-less construction of a Proxy from a HandleType using the Named Constructor idiom.
الاستخدام والدلالات
تُستخدم دالة المصنع الثابتة Create وفقًا لـ [SWS_CM_10438] لإنشاء مثيل وكيل (<SI>Proxy) خالٍ من الاستثناءات وفقًا لنمط المُنشئ المسمى (Named-Constructor-Idiom). وتتطلب كمعلمة handle مقبض خدمة محدد مسبقًا وفقًا لـ [SWS_CM_00131]. ويتم الاستدعاء بشكل متزامن ومُصرح عنه بصفة noexcept. وتُعاد النتيجة في ara::core::Result يحتوي في حالة النجاح على مثيل الوكيل الجاهز للتشغيل.
معالجة الأخطاء
إذا حدث خطأ أثناء إنشاء المثيل، تُرجع Create عبر ara::core::Result رمز خطأ من النوع ara::com::ComErrc [SWS_CM_10438]:
ComErrc::kServiceNotAvailable: لم تعد الخدمة متاحة بعد أن تم تقديمها مسبقًا عبرOfferService().ComErrc::kCommunicationFailure: يبلغ ربط الشبكة عن خطأ اتصال قابل للإصلاح أو عن فشل اتصال آمن.
يُظهر كلا الخطأين دلالات التراجع (Rollback-Semantik) [SWS_CM_10438]. وفي حال وجود أخطاء هيكلية أو متعلقة بالأمان، تسري الانتهاكات المحددة (Violations): إذا كان المقبض الممرر فارغًا (null) أو تالفًا، يكون هناك ErroneousServiceHandleViolation. وإذا كانت العملية المستدعية تفتقر إلى الأذونات اللازمة للمثيل في إطار فرض الأذونات (Grant Enforcement)، يُرفض الطلب ويُعامل كـ InsufficientPermissionsViolation (SWS CommunicationManagement §8 «Security»، [SWS_CM_10438]).
التزامن والشروط الحدية
التفسير: نظرًا لأن Create تعمل بشكل متزامن وتقوم بربط موارد الاتصال، فيُرجح أن الاستدعاء قابل لإعادة الدخول (reentrant) لمقابض مختلفة، إلا أنه لا ينبغي تنفيذه في حلقات زمنية حرجة في الوقت الحقيقي الصارم (Hard-Realtime) بسبب تهيئات الشبكة المحتملة. سؤال Q-f7ba23670f562788 (مفتوح)
تم إنشاء هذا النص بواسطة نظام ذكاء اصطناعي استنادًا إلى مواصفات AUTOSAR R25-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
| Header-Datei | #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" |
|---|---|
| Scope | class <SI-Namespace>::proxy::<SI>Proxy |
| Exception-Sicherheit | exception safe |
| Verletzungen (Violations) | ErroneousService- Provided HandleType is null or corrupt HandleViolation InsufficientPer- Refused by Grant Enforcement missionsViolation |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| handle | As per [SWS_CM_00131] |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Result< {<service-interface-name> }Proxy > | • If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a Proxy • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| ComErrc::kServiceNotAvailable | rollback_semantics Service is not available after being previously offered via Offer Service() |
| ComErrc::kCommunicationFailure | rollback_semantics The network binding reported a recoverable communications error or a secure communication failure |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_CM_10438- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_CM_10438@rel:R25-11#26a7a751- Content hash
26a7a751- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_10438
Status: valid/unmigrated
Version: rel:R25-11#cfeddea9
Versionshistorie & Revisions (1 transition, 8 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_CM_10438@rel:R25-11#cfeddea9
Recorded Revisions (8):
- R25-11
rel:R25-11#b417ae7a2026-09-30 - R19-11
rel:R19-11#7e4e18b92026-10-14 - R20-11
rel:R20-11#f1232f7e2026-10-14 - R21-11
rel:R21-11#f1232f7e2026-10-14 - R22-11
rel:R22-11#38bf837e2026-10-14 - R23-11
rel:R23-11#38bf837e2026-10-14 - R24-11
rel:R24-11#08265d1c2026-10-14 - R25-11
rel:R25-11#cfeddea92026-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 · الأصل الألماني