دالة Disable [SWS_PHM_01380] Upstream: RS_PHM_00101, RS_AP_00159
ara::core::Future< void > Disable () noexcept;
Disable supervision until Enable() is called.
الاستخدام
تُستخدم الدالة Disable() من الفئة ara::phm::SupervisedEntity لإلغاء تفعيل مراقبة كيان ما، إلى أن تتم إعادة تفعيله عبر Enable() [SWS_PHM_01380]. ويتم استدعاء الطريقة بدون معلمات، كما أنها مُعلنة كآمنة ضد الاستثناءات (noexcept) [SWS_PHM_01380]. وتُرجع كقيمة إرجاع ara::core::Future<void>، يمكن من خلاله الاستعلام عن نتيجة إلغاء التفعيل غير المتزامن [SWS_PHM_01380].
معالجة الأخطاء
في حالة النجاح، يُرجع Future القيمة void. وإذا حدث خطأ أثناء إلغاء التفعيل، يحتوي الـ Future على رمز خطأ من مجال الخطأ PhmErrc [SWS_PHM_01380]، [SWS_PHM_01240]. وبشكل خاص، يتم إرجاع الخطأ PhmErrc::kServiceNotReady إذا كان هناك بالفعل طلب Enable() أو Disable() لم يكتمل بعد [SWS_PHM_01380]، [SWS_PHM_01240]. وقد تم تحديد دلالات التراجع (Rollback) لحالة الخطأ هذه [SWS_PHM_01380].
التزامن والتفاعل
تم تصنيف الطريقة على أنها غير آمنة لخيوط المعالجة (not-threadsafe) [SWS_PHM_01380]. لذلك يجب مزامنة الاستدعاءات المتوازية على نفس المثيل من SupervisedEntity. تفسير: يُرجح ألا يُعتبر الطلب الجاري منتهيًا إلا بعد أن يصبح Future المُرجع جاهزًا، بحيث ينبغي تجنب الاستدعاءات اللاحقة حتى ذلك الحين لاستبعاد PhmErrc::kServiceNotReady. سؤال Q-ffc7fc693d7ddbe9 (مفتوح) وبعد إلغاء التفعيل بنجاح، تظل المراقبة غير نشطة إلى أن تتم إعادة تشغيل المراقبة بواسطة Enable() — إذا كان ذلك مسموحًا به في حالة مجموعة الوظائف الحالية — [SWS_PHM_01130].
تم إنشاء هذا النص بواسطة نظام ذكاء اصطناعي بناءً على المواصفة.
| Header-Datei | #include "ara/phm/supervised_entity.h" |
|---|---|
| Scope | class ara::phm::SupervisedEntity |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | not-threadsafe |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Future< void > | void if successful, otherwise an error |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| PhmErrc::kServiceNotReady | rollback_semantics There is already an ongoing Enable or Disable request. |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_PHM_01380- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_PHM_01380@rel:R25-11#fc692221- Content hash
fc692221- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01380
Status: valid/unmigrated
Version: rel:R25-11#45d48541
Versionshistorie & Revisions (1 transition)
- 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_PHM_01380@rel:R25-11#45d48541
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 · الأصل الألماني