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), который предоставляет аутентифицированному клиенту дополнительные права доступа к диагностическим ресурсам помимо диагностического экстракта 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]. В этом случае действует семантика отката, так что не остается никаких несогласованных частичных изменений состояния аутентификации или списков доступа клиента.

Опирается на спецификацию диагностического интерфейса 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 в настоящее время недоступны. Для этого случая ошибки действует семантика отката, благодаря чему сохраняется прежнее состояние списка доступа [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#3f78e34c
Content hash
3f78e34c
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], так что при создании не возникает кодов ошибок или исключений.

Для передачи и жизненного цикла созданного объекта действуют следующие ограничения:

  • Конструктор копирования и оператор присваивания копированием явно удалены ([SWS_DM_01150], [SWS_DM_01151]).
  • Конструктор перемещения [SWS_DM_01148] и оператор присваивания перемещением [SWS_DM_01149] поддерживаются.
  • Все методы экземпляра, такие как Set [SWS_DM_01153], Append [SWS_DM_01152], Revoke [SWS_DM_01154], а также деструктор [SWS_DM_01147], определены как непотокобезопасные (not thread-safe).

В общей системе 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#3da1201d
Content hash
3da1201d
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#34f15666
Content hash
34f15666
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#387d8a40
Content hash
387d8a40
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, полученного приложением от Diagnostic Server после успешного завершения Authenticate или OverrideDefaultRoles (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). Вопрос Q-b07e81ff4629ada7 (открытый) Функция объявлена как noexcept и является безопасной относительно исключений (exception safe), однако специфицирована как непотокобезопасная (not thread-safe) [SWS_DM_01155]. Конкурентные вызовы для одного и того же экземпляра должны поэтому синхронизироваться вызывающей стороной.

Если операция завершается сбоем, функция возвращает через ara::core::Result<void> код ошибки DiagErrc::kServiceNotAvailable [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#e0c9315a
Content hash
e0c9315a
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 с семантикой отката ([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#7ca8f5bf
Content hash
7ca8f5bf
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>. Он работает с семантикой отката: если вызов не может быть выполнен из-за того, что важная функциональность 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#d4da5b5d
Content hash
d4da5b5d
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#86b99512
Content hash
86b99512
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#033af1ca
Content hash
033af1ca
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#a8040400
Content hash
a8040400
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