DEENESPTFRRUARHIKOZHNL

فئة ara::diag::ClientAuthenticationHandle

[SWS_DM_01145] Upstream: RS_Diag_04251

class ClientAuthenticationHandle final {...};

Definition of the ClientAuthenticationHandle which is returned to the application when an AuthenticationState is set by the application.

Header-Datei#include "ara/diag/client_authentication_handle.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

دليل المستخدممولَّد بالذكاء الاصطناعي

يدير أذونات التشخيص الديناميكية، ومؤقتات الجلسة، وإلغاء مصادقة عميل التشخيص.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ceee534cb2db المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يدير أذونات التشخيص الديناميكية، ومؤقتات الجلسة، وإلغاء مصادقة عميل التشخيص.

تُستخدم الفئة ara::diag::ClientAuthenticationHandle بواسطة التطبيق لإدارة جلسة مصادقة نشطة لعميل تشخيص [SWS_DM_01206]. ومن خلال هذا المقبض، يقوم التطبيق بتهيئة قوائم الوصول الديناميكية وتجديد مؤقتات عدم نشاط العميل [SWS_DM_01213]. يتبع الكائن دلالات نقل صارمة دون إمكانية النسخ، ويُبلّغ عن الأخطاء في حال عدم توفر إدارة التشخيص عبر DiagErrc::kServiceNotAvailable. ومن خلال استدعاء Revoke، يمكن سحب الأدوار الممنوحة والأذونات الإضافية بشكل متحكَّم فيه في أي وقت.

السياق

تم تعريف فئة API ara::diag::ClientAuthenticationHandle في ملف الرأس ara/diag/client_authentication_handle.h [SWS_DM_01145]. وهي تعمل ككائن تحكم مركزي يوفره كائن Diagnostic Server لتطبيق التشخيص بمجرد مصادقة العميل بنجاح أو تجاوز أدواره القياسية مؤقتًا AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle».

عند بدء تشغيل النظام، يكون العميل افتراضيًا في الحالة kDeAuthenticated [SWS_DM_01205] مع أدوار قياسية مسبقة التهيئة [SWS_DM_01204]. إذا استدعى التطبيق ara::diag::ClientAuthentication::Authenticate، ينقل Diagnostic Server العميل إلى الحالة kAuthenticated ويُرجع ara::diag::ClientAuthenticationHandle [SWS_DM_01206]. وبالمثل، يتم إنشاء مثل هذا المقبض عند استدعاء ara::diag::ClientAuthentication::OverrideDefaultRoles لتعديل الأدوار مؤقتًا [SWS_DM_01209]. وعبر المقبض، يتحكم التطبيق في حالة المصادقة وقائمة الوصول الديناميكية (DynamicAccessList)، والتي تمنح عميلًا تمت مصادقته حقوق وصول إضافية إلى موارد التشخيص تتجاوز Diagnostic Extract AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle».

diag_auth_context Anwendung Anwendung ClientAuthenticationHandle ClientAuthenticationHandle Anwendung->ClientAuthenticationHandle steuert Zugriff DiagnosticServer DiagnosticServer ClientAuthenticationHandle->DiagnosticServer aktualisiert Sitzung DiagnoseClient DiagnoseClient DiagnoseClient->DiagnosticServer sendet UDS-Anfragen

مخطط السياق: التفاعل بين التطبيق وClientAuthenticationHandle وDiagnostic Server. المصادر: [SWS_DM_01206]، [SWS_DM_01209]، AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»

دورة الحياة

يتم إنشاء كائنات ara::diag::ClientAuthenticationHandle بصورة اعتيادية عبر دوال المصنع الخاصة بـ Diagnostic Server في سياق Authenticate [SWS_DM_01206] أو OverrideDefaultRoles [SWS_DM_01209]. إضافة إلى ذلك، توفر الفئة منشئًا افتراضيًا بدون معلمات [SWS_DM_01146]؛ ويُفترض على الأرجح أن الكائن المنشأ بهذه الطريقة يعمل كعنصر نائب غير مقترن حتى يُنقل إليه مقبض نشط عبر تعيين النقل. سؤال Q-74f44c072616cce9 (مفتوح)

فيما يتعلق بملكية الموارد، تطبق الفئة دلالات نقل صارمة: تم تعريف منشئ النقل [SWS_DM_01148] وعامل تعيين النقل [SWS_DM_01149] كـ noexcept = default. والنسخ محظور تمامًا، حيث تم حذف منشئ النسخ [SWS_DM_01150] وعامل تعيين النسخ [SWS_DM_01151] (=delete). ويتم تحرير الكائن عبر الهادم ~ClientAuthenticationHandle() [SWS_DM_01147].

فيما يتعلق بالتزامن، تم تحديد المنشئ الافتراضي على أنه آمن لتعدد مؤشرات الترابط (thread-safe) [SWS_DM_01146]. في المقابل، حُدد الهادم [SWS_DM_01147] وجميع استدعاءات الدوال المغيرة للحالة على أنها غير آمنة لتعدد مؤشرات الترابط (not thread-safe) [SWS_DM_01152]، [SWS_DM_01153]، [SWS_DM_01154]، [SWS_DM_01155]. ولذلك، يتطلب الوصول المتزامن إلى المقبض نفسه إجراء مزامنة من جانب التطبيق.

مسار الاستخدام

يتضمن المسار النموذجي أثناء التشغيل تهيئة الأذونات الديناميكية، والحفاظ على التفويض، والإنهاء المتحكَّم فيه:

  1. الحصول على المقبض: يبدأ التطبيق المصادقة في ara::diag::ClientAuthentication ويستلم كائن المقبض [SWS_DM_01206].
  2. تعيين قائمة الوصول أو توسيعها: عبر الدالة Set، يستبدل التطبيق قائمة الوصول الديناميكية لمحادثة تشخيصية بالكامل [SWS_DM_01153]، [SWS_DM_01213]. وبدلاً من ذلك، تُلحق Append أنماط تشخيص إضافية بقائمة وصول موجودة [SWS_DM_01152] AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.4 «DynamicAccessList Creation and Update».
  3. تجديد النشاط: في حالة عدم النشاط في الجلسة القياسية، ينشأ خطر الرجوع التلقائي إلى kDeAuthenticated بعد انقضاء مهلة عدم النشاط [SWS_DM_01210]. وعبر استدعاء Refresh، يمدد التطبيق المؤقتات التي بدأتها Authenticate أو OverrideDefaultRoles [SWS_DM_01155] AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle».
  4. إلغاء الأذونات: باستخدام Revoke، يُلغي التطبيق مصادقة العميل صراحةً، ويحذف DynamicAccessList المرتبطة، ويعيد تعيين الأدوار القياسية التي تم تجاوزها [SWS_DM_01154].
التحكم في المصادقة والوصول عبر ClientAuthenticationHandleالتطبيقClientAuthenticationClientAuthenticationHandleDiagnosticServerUse Case: المصادقة وتوفير المقبضAuthenticate(roles)تعيين الحالة إلى kAuthenticatedClientAuthenticationHandleUse Case: تهيئة الصلاحيات وتحديث المؤقتSet(dynamicAccessList)DynamicAccessList ersetzenResult<void>Refresh()Inaktivitaetstimer zuruecksetzenResult<void>Use Case: SitzungsbeendigungRevoke()kDeAuthenticated & Rechte loeschenResult<void>

مخطط التسلسل: مسار المصادقة، وإدارة الحقوق، والإلغاء عبر المقبض. المصادر: [SWS_DM_01206]، [SWS_DM_01153]، [SWS_DM_01155]، [SWS_DM_01154]

سيناريوهات الأخطاء

تُرجع الدوال التشغيلية Set [SWS_DM_01153]، Append [SWS_DM_01152]، Refresh [SWS_DM_01155] وRevoke [SWS_DM_01154] في كل حالة ara::core::Result<void>، وهي مصرَّح عنها كـ noexcept وآمنة من الاستثناءات (exception safe).

إذا فشل الاتصال أو التنفيذ بسبب عدم توفر وظائف أساسية لـ Diagnostic Manager في الوقت الحالي، تُرجع الاستدعاءات رمز الخطأ DiagErrc::kServiceNotAvailable [SWS_DM_01152]، [SWS_DM_01153]، [SWS_DM_01154]، [SWS_DM_01155]. وفي هذه الحالة، تُطبق دلالات التراجع (Rollback)، بحيث لا تبقى أي تغييرات جزئية غير متسقة في حالة المصادقة أو قوائم الوصول الخاصة بالعميل.

يستند إلى مواصفة واجهة تشخيص AUTOSAR Adaptive R25-11.

خريطة الأعضاء

المُنشئات والمُتلف

2
ClientAuthenticationHandle~ClientAuthenticationHandle

الدوال الأعضاء

4
AppendRefreshRevokeSet

المعاملات

1
operator=

مخطط الفئة

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__ClientAuthenticationHandle939 ClientAuthenticationHandle + ClientAuthenticationHandle() + ~ClientAuthenticationHandle() + Append() + Refresh() + Revoke() + Set() + operator=()

عرض التفاصيل

اختر عنصرًا من المخطط.

المُنشئات والمُتلف

ClientAuthenticationHandle دالة 3

Constructor of ClientAuthenticationHandle.

التحميلات الزائدة ClientAuthenticationHandle 3
ClientAuthenticationHandle () noexcept; SWS_DM_01146
ClientAuthenticationHandle (ClientAuthenticationHandle &&other) noexcept=default; SWS_DM_01148
ClientAuthenticationHandle (ClientAuthenticationHandle const &other)=delete; SWS_DM_01150
~ClientAuthenticationHandle دالة

Destructor of ClientAuthenticationHandle.

~ClientAuthenticationHandle () noexcept;

الدوال الأعضاء

Append دالة

This function is used by the application to append a DynamicAccessList to the already existing DynamicAccessList of a Diagnostic Conversation.

ara::core::Result< void > Append (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;
Refresh دالة

This function is used by the application to refresh the timer that was started by Authenticate or OverrideDefaultRoles. If both Methods were previously called, both timers are refreshed.

ara::core::Result< void > Refresh () noexcept;
Revoke دالة

This function is used by the application to de-authenticate a client, and also to clear the Dynamic AccessList and any overridden defaults.

ara::core::Result< void > Revoke () noexcept;
Set دالة

This function is used by the application to set/replace a DynamicAccessList of a Diagnostic Conversation.

ara::core::Result< void > Set (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

المعاملات

operator= دالة 2

Move assignment operator of ClientAuthenticationHandle.

التحميلات الزائدة = 2
auto operator= (ClientAuthenticationHandle &&other) & noexcept -> ClientAuthenticationHandle & =default; SWS_DM_01149
auto operator= (ClientAuthenticationHandle const &other) -> Client AuthenticationHandle &=delete; SWS_DM_01151

توثيق الدوال

دالة Append [SWS_DM_01152] Upstream: RS_Diag_04251

ara::core::Result< void > Append (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

This function is used by the application to append a DynamicAccessList to the already existing DynamicAccessList of a Diagnostic Conversation.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ecc404bb2530 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تستخدم التطبيقات الطريقة Append للفئة ara::diag::ClientAuthenticationHandle لإلحاق قائمة وصول ديناميكية (dynamicAccessList) بـ DynamicAccessList الموجودة بالفعل لمحادثة تشخيص نشطة [SWS_DM_01152]. ويتم توفير الواجهة عبر الترويسة ara/diag/client_authentication_handle.h AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.3.1 «Append».

يتم تنفيذ الاستدعاء بشكل متزامن وحُدد كـ noexcept [SWS_DM_01152]. وتأخذ الدالة DiagnosticServiceDynamicAccessList كمعلمة إدخال. ويشير نوع الإرجاع ara::core::Result<void> إلى الاكتمال الناجح أو ينقل كود الخطأ DiagErrc::kServiceNotAvailable في حالة حدوث خطأ [SWS_DM_01152]. ويشير هذا الأخير إلى أن الوظائف الأساسية لـ Diagnostic Management غير متوفرة حاليًا. وتنطبق دلالات التراجع (Rollback Semantics) على حالة الخطأ هذه، بحيث يتم الحفاظ على الحالة السابقة لقائمة الوصول [SWS_DM_01152].

فيما يتعلق بالتزامن، تُعتبر العملية آمنة ضد الاستثناءات (exception safe)، ولكن تم تصنيفها صراحةً بأنها غير آمنة لمؤشرات الترابط (not thread-safe) [SWS_DM_01152]. وبالتالي، عند الوصول المتوازي إلى كائن المقبض نفسه، فمن المرجح أن تكون المزامنة الخارجية ضرورية من قِبل التطبيق المستدعي. سؤال Q-f0da9a0538a86a16 (مفتوح)

أُنشئت ملاحظة الاستخدام هذه تلقائيًا وتستند حصريًا إلى بيانات مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
dynamicAccessListThe DynamicAccessList to be appended in the client.

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01152
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01152@rel:R25-11#2ef8b453
Content hash
2ef8b453
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01152
Status: valid/unmigrated Version: rel:R25-11#760cf1a2 Versionshistorie & Revisions (1 transition, 6 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_01152@rel:R25-11#760cf1a2
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#5fbe369d2026-09-30
  • R21-11rel:R21-11#fe6687392026-10-14
  • R22-11rel:R22-11#4d5753f62026-10-14
  • R23-11rel:R23-11#85d630192026-10-14
  • R24-11rel:R24-11#e44623a72026-10-14
  • R25-11rel:R25-11#760cf1a22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ClientAuthenticationHandle [SWS_DM_01146] Upstream: RS_Diag_04251

ClientAuthenticationHandle () noexcept;

Constructor of ClientAuthenticationHandle.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 970d47856338 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يُنشئ المُنشئ الافتراضي المتزامن [SWS_DM_01146] مثيلاً للفئة ara::diag::ClientAuthenticationHandle. ولا يقبل الاستدعاء أي معلمات تمرير ولا يُرجع أي قيمة. وقد أُعلنت الدالة على أنها noexcept وحُددت على أنها آمنة لخيوط المعالجة (thread-safe) وكذلك آمنة من الاستثناءات [SWS_DM_01146]، بحيث لا تظهر أي رموز أخطاء أو استثناءات أثناء الإنشاء.

تسري القيود التالية على تمرير الكائن المُنشأ ودورة حياته:

في النظام الكلي، يوفر Diagnostic Server المقابض النشطة والمقيدة بعميل بشكل اعتيادي عبر Authenticate [SWS_DM_01142] أو OverrideDefaultRoles [SWS_DM_01141] (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). لذلك يُرجح أن يعمل النموذج المُنشأ عبر المُنشئ الافتراضي كعنصر نائب غير مقيد، لا يأخذ مقبضًا صالحًا للتحكم في قوائم الوصول إلا من خلال عملية التعيين بالنقل اللاحقة [SWS_DM_01149]. سؤال Q-ce182402bd1d4072 (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01146
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01146@rel:R25-11#70b329cb
Content hash
70b329cb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01146
Status: valid/unmigrated Version: rel:R25-11#e53f888a Versionshistorie & Revisions (1 transition, 6 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_01146@rel:R25-11#e53f888a
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#343d84612026-09-30
  • R21-11rel:R21-11#382fc8b12026-10-14
  • R22-11rel:R22-11#1b1476a42026-10-14
  • R23-11rel:R23-11#ae2414252026-10-14
  • R24-11rel:R24-11#2fa9197f2026-10-14
  • R25-11rel:R25-11#e53f888a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ClientAuthenticationHandle [SWS_DM_01148] Upstream: RS_Diag_04251

ClientAuthenticationHandle (ClientAuthenticationHandle &&other) noexcept=default;

Move constructor of ClientAuthenticationHandle.

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherObject to move-construct from

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01148
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01148@rel:R25-11#0ef253bd
Content hash
0ef253bd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01148
Status: valid/unmigrated Version: rel:R25-11#61fab40f Versionshistorie & Revisions (1 transition, 6 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_01148@rel:R25-11#61fab40f
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#398da6ac2026-09-30
  • R21-11rel:R21-11#4ded0cd12026-10-14
  • R22-11rel:R22-11#6906c58f2026-10-14
  • R23-11rel:R23-11#9b4b55cb2026-10-14
  • R24-11rel:R24-11#ce30ca042026-10-14
  • R25-11rel:R25-11#61fab40f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ClientAuthenticationHandle [SWS_DM_01150] Upstream: RS_Diag_04251

ClientAuthenticationHandle (ClientAuthenticationHandle const &other)=delete;

Copy constructor of ClientAuthenticationHandle cannot be used.

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01150
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01150@rel:R25-11#90124d28
Content hash
90124d28
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01150
Status: valid/unmigrated Version: rel:R25-11#5c00c5f2 Versionshistorie & Revisions (1 transition, 6 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_01150@rel:R25-11#5c00c5f2
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#b2ba2b412026-09-30
  • R21-11rel:R21-11#be3428ad2026-10-14
  • R22-11rel:R22-11#7ad065b42026-10-14
  • R23-11rel:R23-11#f8cce9ac2026-10-14
  • R24-11rel:R24-11#5c00c5f22026-10-14
  • R25-11rel:R25-11#5c00c5f22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة Refresh [SWS_DM_01155] Upstream: RS_Diag_04251

ara::core::Result< void > Refresh () noexcept;

This function is used by the application to refresh the timer that was started by Authenticate or OverrideDefaultRoles. If both Methods were previously called, both timers are refreshed.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 8c9744884d32 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة Refresh للفئة ara::diag::ClientAuthenticationHandle (ملف الرأس #include "ara/diag/client_authentication_handle.h") بواسطة أحد التطبيقات لتمديد مؤقتات المصادقة أو الأدوار النشطة (AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.3.2 «Refresh»). وهي تعيد تعيين المؤقت الذي تم تشغيله سابقًا بواسطة Authenticate أو OverrideDefaultRoles. وإذا تم استدعاء كلتا الطريقتين مسبقًا، فسيتم تجديد كلا المؤقتين في الوقت نفسه بواسطة الاستدعاء [SWS_DM_01155].

يتم الاستدعاء المتزامن (تفسير: إرجاع مباشر بدون كائن Future غير متزامن) بدون معلمات على مثيل موجود من ClientAuthenticationHandle، والذي حصل عليه التطبيق من خادم التشخيص بعد إتمام Authenticate أو OverrideDefaultRoles بنجاح (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). سؤال Q-b07e81ff4629ada7 (مفتوح) تم التصريح عن الدالة كـ noexcept وهي آمنة من الاستثناءات (exception safe)، ولكن تم تحديدها على أنها غير آمنة لخيوط المعالجة (not thread-safe) [SWS_DM_01155]. لذلك يجب مزامنة الاستدعاءات المتزامنة على نفس المثيل بواسطة المستدعي.

إذا فشلت العملية، تُرجع الدالة رمز الخطأ DiagErrc::kServiceNotAvailable عبر ara::core::Result<void> [SWS_DM_01155]. ويشير هذا عبر دلالات التراجع إلى أنه تعذر تنفيذ الاستدعاء نظرًا لأن الوظائف الأساسية لـ Diagnostic Management (DM) غير متوفرة حاليًا [SWS_DM_01155].

تم إنشاء إشعار الاستخدام هذا آليًا بناءً على مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01155
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01155@rel:R25-11#5c2d8fd5
Content hash
5c2d8fd5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01155
Status: valid/unmigrated Version: rel:R25-11#336ea0d5 Versionshistorie & Revisions (1 transition, 6 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_01155@rel:R25-11#336ea0d5
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#b5659ac02026-09-30
  • R21-11rel:R21-11#f05c61ca2026-10-14
  • R22-11rel:R22-11#2739c0e72026-10-14
  • R23-11rel:R23-11#ebcd83152026-10-14
  • R24-11rel:R24-11#aa896f602026-10-14
  • R25-11rel:R25-11#336ea0d52026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة Revoke [SWS_DM_01154] Upstream: RS_Diag_04251

ara::core::Result< void > Revoke () noexcept;

This function is used by the application to de-authenticate a client, and also to clear the Dynamic AccessList and any overridden defaults.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 97421a5ce76e المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة المتزامنة Revoke للفئة ara::diag::ClientAuthenticationHandle (SWS Diagnostics §8.6.1.1.3.3 «Revoke») من قِبل التطبيقات لإلغاء مصادقة عميل تشخيص تمت مصادقته مسبقًا، بالإضافة إلى التجاهل التام لقائمة الوصول الديناميكية (DynamicAccessList) الخاصة به وأدواره الافتراضية التي تم تجاوزها ([SWS_DM_01154]، [SWS_DM_01216]).

لا تحتوي الدالة على معلمات تمرير وتُرجع ara::core::Result<void> ([SWS_DM_01154]). وفي حالة النجاح، يتم إنهاء حالة مصادقة العميل. وإذا لم تكن هناك وظيفة أساسية لـ Diagnostic Manager متوفرة في وقت الاستدعاء، تفشل العملية وتُرجع الخطأ DiagErrc::kServiceNotAvailable بدلالات التراجع (Rollback Semantics) ([SWS_DM_01154]).

فيما يتعلق بالتزامن، تم تحديد الواجهة بأنها آمنة ضد الاستثناءات (exception safe)، ولكنها غير آمنة لمؤشرات الترابط (not thread-safe) ([SWS_DM_01154]). تفسير: عند الوصول المتزامن إلى مثيل المقبض نفسه من عدة مؤشرات ترابط، فمن المرجح إذن أن يضطر التطبيق المستدعي إلى ضمان مزامنة خارجية. سؤال Q-8781261c9a2f5f8e (مفتوح)

في سير العمل الإجمالي، يتم توفير مثيل ClientAuthenticationHandle للتطبيق بعد نجاح المصادقة أو بعد تجاوز الأدوار الافتراضية بواسطة مثيل خادم التشخيص (SWS Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). وبينما يتيح المقبض النشط، إلى جانب الإلغاء، استبدال ([SWS_DM_01213]) أو توسيع ([SWS_DM_01215]) DynamicAccessList، فإن Revoke تُنهي صلاحيات العميل هذه بشكل نهائي.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Adaptive R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01154
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01154@rel:R25-11#28a6b1db
Content hash
28a6b1db
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01154
Status: valid/unmigrated Version: rel:R25-11#d654e83e Versionshistorie & Revisions (1 transition, 6 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_01154@rel:R25-11#d654e83e
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#0fc0c68f2026-09-30
  • R21-11rel:R21-11#341b16582026-10-14
  • R22-11rel:R22-11#b81da6112026-10-14
  • R23-11rel:R23-11#4f5f61352026-10-14
  • R24-11rel:R24-11#6d88b2f82026-10-14
  • R25-11rel:R25-11#d654e83e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة Set [SWS_DM_01153] Upstream: RS_Diag_04251

ara::core::Result< void > Set (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

This function is used by the application to set/replace a DynamicAccessList of a Diagnostic Conversation.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 8ef0a8bd09d8 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة المتزامنة Set للفئة ara::diag::ClientAuthenticationHandle ([SWS_DM_01153]) لتمكين أحد التطبيقات من تعيين قائمة الوصول الديناميكية (DynamicAccessList) لمحادثة تشخيص أو لعميل تمت مصادقته في Diagnostic Server، أو استبدالها بالكامل ([SWS_DM_01213]). يحتفظ Diagnostic Manager لكل عميل تمت مصادقته بمثل هذه DynamicAccessList، والتي يمكنها منح العميل حقوق وصول إضافية إلى موارد التشخيص تتجاوز التكوين المحفوظ في Diagnostic Extract (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»).

عند الاستخدام، تكون الجوانب التالية حاسمة:

  • سياق الاستدعاء والمعلمات: يتم استدعاء الدالة على مثيل لـ ara::diag::ClientAuthenticationHandle (مصرّح عنه في #include "ara/diag/client_authentication_handle.h"). ويتم توفير مثل هذا المثيل للمقبض للتطبيق عندما يكتمل بنجاح مسبقًا إما ara::diag::ClientAuthentication::Authenticate ([SWS_DM_01206]) أو ara::diag::ClientAuthentication::OverrideDefaultRoles ([SWS_DM_01209]). وبصفتها معلمة التمرير الوحيدة، يتم تمرير dynamicAccessList من النوع DiagnosticServiceDynamicAccessList، والتي تحدد قائمة الوصول الجديدة ([SWS_DM_01153]).
  • قيمة الإرجاع ومعالجة الأخطاء: الطريقة محددة كـ noexcept وتُرجع ara::core::Result<void>. وهي تعمل وفق دلالات التراجع (Rollback Semantics): فإذا تعذر تنفيذ الاستدعاء بسبب عدم توفر وظيفة DM أساسية حاليًا، يفشل الاستدعاء مع كود الخطأ DiagErrc::kServiceNotAvailable ([SWS_DM_01153]). وفيما يتعلق بمعالجة الاستثناءات، تُصنف الطريقة بأنها آمنة ضد الاستثناءات (exception safe).
  • التزامن: تم تعريف العملية صراحةً بأنها غير آمنة لمؤشرات الترابط (not thread-safe) ([SWS_DM_01153]). وإذا تم إجراء استدعاءات على مثيل المقبض نفسه بالتزامن من عدة مؤشرات ترابط، فإن المزامنة اللازمة تقع على عاتق التطبيق.

تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
dynamicAccessListThe new DynamicAccessList to be set in the client.

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01153
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01153@rel:R25-11#95447cd2
Content hash
95447cd2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01153
Status: valid/unmigrated Version: rel:R25-11#6e0f3d93 Versionshistorie & Revisions (1 transition, 6 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_01153@rel:R25-11#6e0f3d93
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#850c01d82026-09-30
  • R21-11rel:R21-11#4dff11b12026-10-14
  • R22-11rel:R22-11#5a0f43622026-10-14
  • R23-11rel:R23-11#768f7ce22026-10-14
  • R24-11rel:R24-11#bac10bed2026-10-14
  • R25-11rel:R25-11#6e0f3d932026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_DM_01149] Upstream: RS_Diag_04251

auto operator= (ClientAuthenticationHandle &&other) & noexcept -> ClientAuthenticationHandle & =default;

Move assignment operator of ClientAuthenticationHandle.

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherObject to move-assign from.

Rückgabewert

TypBeschreibung
ClientAuthenticationHandleClientAuthenticationHandle& Reference to self.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01149
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01149@rel:R25-11#95581821
Content hash
95581821
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01149
Status: valid/unmigrated Version: rel:R25-11#6d429c60 Versionshistorie & Revisions (1 transition, 6 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_01149@rel:R25-11#6d429c60
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#825bafd02026-09-30
  • R21-11rel:R21-11#6b6602162026-10-14
  • R22-11rel:R22-11#7c114d032026-10-14
  • R23-11rel:R23-11#f26ac2222026-10-14
  • R24-11rel:R24-11#13552b832026-10-14
  • R25-11rel:R25-11#6d429c602026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_DM_01151] Upstream: RS_Diag_04251

auto operator= (ClientAuthenticationHandle const &other) -> Client AuthenticationHandle &=delete;

Copy assignment operator of CancellationHandler cannot be used.

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01151
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01151@rel:R25-11#c6c63183
Content hash
c6c63183
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01151
Status: valid/unmigrated Version: rel:R25-11#41e0cc7a Versionshistorie & Revisions (1 transition, 6 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_01151@rel:R25-11#41e0cc7a
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#e7f217352026-09-30
  • R21-11rel:R21-11#e234b1652026-10-14
  • R22-11rel:R22-11#8556e28c2026-10-14
  • R23-11rel:R23-11#114f1c5c2026-10-14
  • R24-11rel:R24-11#41e0cc7a2026-10-14
  • R25-11rel:R25-11#41e0cc7a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ~ClientAuthenticationHandle [SWS_DM_01147] Upstream: RS_Diag_04251

~ClientAuthenticationHandle () noexcept;

Destructor of ClientAuthenticationHandle.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 284dd06f8411 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

الدالة ~ClientAuthenticationHandle() هي مُتلف الفئة ara::diag::ClientAuthenticationHandle ويتم التصريح عنها عبر ملف الترويسة ara/diag/client_authentication_handle.h ([SWS_DM_01147]، AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.1.3 «Destructor»). وهي لا تقبل أي معلمات تمرير ولا تُرجع أي قيمة إرجاع. ويحدث الاستدعاء عادةً بشكل ضمني عند انتهاء دورة حياة الكائن. تفسير: من المرجح أن يتم عندئذٍ تحرير جميع الموارد المرتبطة بمصادقة العميل والمحجوزة داخليًا بواسطة المقبض. سؤال Q-ea8f47232fd9951f (مفتوح)

معالجة الأخطاء والأمان من الاستثناءات

المُتلف مصرّح عنه كـ noexcept ومحدد صراحةً بأنه exception safe ([SWS_DM_01147]). وبالتالي، لا يتم إطلاق أي استثناءات C++ ولا يتم الإبلاغ عن أكواد أخطاء محددة أثناء إتلاف الكائن، مما يضمن اكتمال عملية التنظيف دون أخطاء.

التزامن والقيود

صُنِّف إتلاف كائن ClientAuthenticationHandle وفقًا للمواصفة بأنه not thread-safe ([SWS_DM_01147]). ويجب على التطبيق المستدعي التأكد من عدم وصول أي مؤشرات ترابط أخرى بالتوازي إلى المثيل نفسه أثناء تنفيذ المُتلف.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Adaptive R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/client_authentication_handle.h"
Scopeclass ara::diag::ClientAuthenticationHandle
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01147
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01147@rel:R25-11#ea6c5f16
Content hash
ea6c5f16
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01147
Status: valid/unmigrated Version: rel:R25-11#b9cd7178 Versionshistorie & Revisions (1 transition, 6 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_01147@rel:R25-11#b9cd7178
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#f9cc0a482026-09-30
  • R21-11rel:R21-11#3b91d66c2026-10-14
  • R22-11rel:R22-11#cca9279f2026-10-14
  • R23-11rel:R23-11#4de7c36f2026-10-14
  • R24-11rel:R24-11#0092ff1b2026-10-14
  • R25-11rel:R25-11#b9cd71782026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill