DEENESPTFRRUARHIKOZHNL

فئة ara::crypto::cryp::EncryptorPublicCtx

[SWS_CRYPT_50173] Upstream: RS_CRYPTO_02201

class EncryptorPublicCtx :             public CryptoContext {...};

Interface for asymmetric encryption.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::cryp
Basisklasse(n)CryptoContext

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

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

يشفر البيانات بشكل غير متماثل في خطوة واحدة أو عبر عملية تدفق متعددة الأجزاء.

تُستخدم الواجهة للتشفير غير المتماثل لبيانات النص الصريح على AUTOSAR Adaptive Platform وتُدار عبر المؤشر الذكي المقدم [SWS_CRYPT_50174]. وبعد تعيين مفتاح عام مطابق، يمكن تحويل الرسائل إما بشكل مدمج في دورة واحدة أو بشكل مستمر عبر جلسة تدفق متعددة الأجزاء [SWS_CRYPT_50090]. وللتنفيذ الصحيح، يجب حساب أحجام المخازن المؤقتة مسبقًا، حيث تم تحديد جميع عمليات السياق لتكون آمنة من الاستثناءات وآمنة بالنسبة للخيوط.

السياق

توفر فئة ++C‏ ara::crypto::cryp::EncryptorPublicCtx الواجهة القياسية لتشفير البيانات غير المتماثل في AUTOSAR Adaptive Platform. وتُستخدم من تطبيقات العميل لتشفير بيانات النص الصريح باستخدام مفتاح عام غير متماثل. يمكن تكوين المفتاح التشفيري إما مباشرةً عبر كائن مفتاح ([SWS_CRYPT_50175]) أو عبر مرجع إلى موضع تخزين المفتاح (KeySlot، [SWS_CRYPT_50086]). يتم تمرير البيانات عبر نطاقات مخزن مؤقت تتسم بكفاءة الذاكرة (ReadOnlyMemRegion لبيانات النص الصريح وReadWriteMemRegion لإخراج النص المشفر).

دورة الحياة

تُدار مثيلات السياق عبر المؤشر المشترك std::shared_ptr<EncryptorPublicCtx> المحدد في الاسم المستعار للنوع Sptr ([SWS_CRYPT_50174]). والإنشاء نفسه ليس جزءًا من تعريف هذه الواجهة؛ ويُفترض أن إنشاء المثيل يتم عبر مكوّن مصنع (Factory) ذي مستوى أعلى في بنية التشفير. سؤال Q-5b7490ba113bb861 (مفتوح) يمر الكائن أثناء دورة حياته بحالات محددة بوضوح:

  • غير مهيأ: بعد إنشاء المثيل، لا يمتلك السياق مفتاحًا بعد. ولا يُسمح بعمليات معالجة البيانات في هذه الحالة.
  • مكوّن (جاهز): عبر استدعاء SetKey() باستخدام PublicKey ([SWS_CRYPT_50175]) أو KeySlot ([SWS_CRYPT_50086])، يصبح السياق جاهزًا للاستخدام. ومن هذه الحالة، يمكن إما تنفيذ تشفير بخطوة واحدة أو بدء جلسة تدفق.
  • التدفق نشط: يؤدي استدعاء Start() ([SWS_CRYPT_50087]) إلى نقل السياق إلى حالة التدفق. وتتم معالجة كتل البيانات المستمرة عبر Update() ([SWS_CRYPT_50176]). يتم إما إنهاء الجلسة باستخدام Finish() ([SWS_CRYPT_50088]) أو إلغاؤها باستخدام Cancel() ([SWS_CRYPT_50089])، مما يعيد السياق مرة أخرى إلى الحالة مكوّن.

تم تحديد جميع أساليب الفئة لتكون آمنة من الاستثناءات (exception safe) وآمنة بالنسبة للخيوط (thread-safe). وإذا تم تدمير السياق بينما لم تكتمل عملية التدفق بعد، فمن المرجح أن يُنظف التنفيذ الأساسي المخازن المؤقتة المخصصة ويتجاهل الجلسة ضمنيًا. سؤال Q-3eadc946a0bdbdfd (مفتوح)

Lebenszyklus Uninitialized غير مهيأ Configured Konfiguriert (Bereit) Uninitialized->Configured SetKey() Configured->Configured SetKey() / Encrypt() Streaming Streaming نشط Configured->Streaming Start() Streaming->Configured Finish() / Cancel() Streaming->Streaming Update()

مخطط الحالة: دورة الحياة وانتقالات الحالة للسياق من التكوين إلى التحويل. المصادر: [SWS_CRYPT_50086]، [SWS_CRYPT_50175]، [SWS_CRYPT_50087]، [SWS_CRYPT_50176]، [SWS_CRYPT_50088]، [SWS_CRYPT_50089]، [SWS_CRYPT_50090]

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

تدعم الفئة نمطي معالجة: المعالجة بخطوة واحدة لمجموعات البيانات الكاملة والتدفق متعدد الخطوات لتدفقات البيانات المقسمة. وقبل تنفيذ عمليات التشفير، يجب على التطبيقات مراعاة حدود المخزن المؤقت:

  • عبر GetMinimumChunkSize()` (<a class="spec-record-ref" data-req="SWS_CRYPT_50178">[SWS_CRYPT_50178]</a>) und <code>GetMaximumChunkSize() ([SWS_CRYPT_50091])، يمكن تحديد أحجام الإدخال الدنيا والقصوى المدعومة للاستدعاءات الفردية.
  • يجب الاستعلام مسبقًا عن السعة اللازمة للمخزن المؤقت للإخراج باستخدام GetRequiredOutputBufferSize() ([SWS_CRYPT_50177]). ويتحكم المعامل isFinal هنا فيما إذا كان الحساب يتم للخطوات الوسيطة (false) أو للاستدعاءات النهائية أو الخطوات الفردية (true).

ينقسم المسار النموذجي لتشفير التدفق إلى الخطوات التالية:

  1. تعيين المفتاح عبر SetKey() باستخدام PublicKey صالح ([SWS_CRYPT_50175]).
  2. تهيئة جلسة التدفق من خلال استدعاء Start() ([SWS_CRYPT_50087]).
  3. حساب حجم المخزن المؤقت للإخراج المطلوب للكتل الوسيطة باستخدام GetRequiredOutputBufferSize(inputSize, false) ([SWS_CRYPT_50177]).
  4. التحويل المتكرر لكتل البيانات عبر Update() ([SWS_CRYPT_50176]).
  5. تحديد حجم المخزن المؤقت للكتلة الأخيرة (isFinal = true) وإنهاء العملية عبر Finish() ([SWS_CRYPT_50088]).

بالنسبة للبيانات المدمجة التي يمكن معالجتها في دورة واحدة، يوفر Encrypt() ([SWS_CRYPT_50090]) استدعاءً مباشرًا بخطوة واحدة دون تقسيم إلى مراحل Start وUpdate وFinish.

سير عملية التشفير التدفقي غير المتماثلالتطبيقEncryptorPublicCtxUse Case: التهيئة والتهيئة الأوليةSetKey(key)Result<void>Start()Result<void>Use Case: Streaming-VerarbeitungGetRequiredOutputBufferSize(inputSize, false)Result<size_t>Update(in, out)Result<size_t> (طول النص المشفر)Use Case: AbschlussGetRequiredOutputBufferSize(finalInputSize, true)Result<size_t>Finish(finalIn, out)Result<size_t> (طول النص المشفر النهائي)

مخطط التسلسل: المسار النموذجي لتشفير تدفق متعدد الأجزاء مع تحديد حجم المخزن المؤقت. المصادر: [SWS_CRYPT_50175]، [SWS_CRYPT_50087]، [SWS_CRYPT_50177]، [SWS_CRYPT_50176]، [SWS_CRYPT_50088]

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

تستخدم جميع الأساليب ara::core::Result للإشارة إلى الأخطاء وتضمن دلالات التراجع (Rollback) في حالة الخطأ:

  • أخطاء الحالة: يؤدي استدعاء Start() أو Encrypt() أو GetRequiredOutputBufferSize() في سياق غير مهيأ إلى ara::crypto::CryptoErrc::kUninitializedContext ([SWS_CRYPT_50087]، [SWS_CRYPT_50090]، [SWS_CRYPT_50177]). إذا استُدعيت Update() أو Finish() أو Cancel() دون تنفيذ Start() مسبقاً، تفشل العملية مع ara::crypto::CryptoErrc::kProcessingNotStarted ([SWS_CRYPT_50176]، [SWS_CRYPT_50088]، [SWS_CRYPT_50089]).
  • أخطاء المفتاح والاستخدام: إذا كان المفتاح أو KeySlot المقدَّم غير متوافق مع السياق، يُبلَّغ عن ara::crypto::CryptoErrc::kIncompatibleObject ([SWS_CRYPT_50175]، [SWS_CRYPT_50086]، [SWS_CRYPT_50087]، [SWS_CRYPT_50090]). وإذا كان الاستخدام المسموح به للمفتاح لا يتضمن الإذن kAllowDataEncryption، فإن ذلك ينتج عنه ara::crypto::CryptoErrc::kUsageViolation ([SWS_CRYPT_50175]، [SWS_CRYPT_50087]، [SWS_CRYPT_50090]). وإذا كان KeySlot المشار إليه فارغاً، يُبلَّغ عن ara::crypto::CryptoErrc::kEmptyKeySlot ([SWS_CRYPT_50087]، [SWS_CRYPT_50090]).
  • أخطاء المخزن المؤقت والبيانات: إذا كان حجم المخزن المؤقت للإخراج الممرَّر صغيراً جداً، تستجيب Encrypt() وUpdate() وFinish() بـ ara::crypto::CryptoErrc::kInsufficientCapacity ([SWS_CRYPT_50090]، [SWS_CRYPT_50176]، [SWS_CRYPT_50088]). تؤدي الانحرافات عن أحجام الكتل (Chunks) المسموح بها إلى ara::crypto::CryptoErrc::kInvalidInputSize، بينما تؤدي بيانات الإدخال غير الصالحة إلى ara::crypto::CryptoErrc::kInvalidArgument.
  • الوظائف غير المدعومة ونقص الموارد: إذا كان التنفيذ لا يدعم البث (Streaming) أو الاستدعاء بخطوة واحدة، تفشل العملية مع ara::crypto::CryptoErrc::kUnsupported ([SWS_CRYPT_50087]، [SWS_CRYPT_50090]، [SWS_CRYPT_50176]، [SWS_CRYPT_50088]). وفي حال حظر الموارد التشفيرية، يُعاد ara::crypto::CryptoErrc::kBusyResource ([SWS_CRYPT_50087]، [SWS_CRYPT_50090]).

يعتمد هذا الدليل على متطلبات إصدار AUTOSAR Adaptive Platform رقم R25-11 ويلخص مواصفة الفئة ara::crypto::cryp::EncryptorPublicCtx.

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

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

9
CancelEncryptFinishGetMaximumChunkSizeGetMinimumChunkSizeGetRequiredOutputBufferSizeSetKeyStartUpdate

أسماء الأنواع البديلة

1
Sptr

مخطط الفئة

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

G nara__crypto__cryp__EncryptorPublicCtx829 EncryptorPublicCtx + Cancel() + Encrypt() + Finish() + GetMaximumChunkSize() + GetMinimumChunkSize() + GetRequiredOutputBufferSize() + SetKey() + Start() + Update() nara__crypto__cryp__CryptoContext85 CryptoContext nara__crypto__cryp__EncryptorPublicCtx829->nara__crypto__cryp__CryptoContext85

عرض التفاصيل

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

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

Cancel دالة

Cancel the ongoing streaming operation that has been initiated by Start() and has not yet been finished.

virtual ara::core::Result< void > Cancel () noexcept=0;
Encrypt دالة

Encrypt data in a single-call.

virtual ara::core::Result< std::size_t > Encrypt (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;
Finish دالة

Finalize the encryption.

virtual ara::core::Result< std::size_t > Finish (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;
GetMaximumChunkSize دالة

Get the maximum input buffer size supported for processing in single calls to Update(), Finish(), or Encrypt() by this context.

virtual ara::core::Result< std::size_t > GetMaximumChunkSize () const noexcept=0;
GetMinimumChunkSize دالة

Get the minimum input buffer size supported for processing in single calls to Update(), Finish(), or Encrypt() by this context.

virtual ara::core::Result< std::size_t > GetMinimumChunkSize () const noexcept=0;
GetRequiredOutputBufferSize دالة

Calculate the maximum required size of the output buffer depending on the input size in the current state of the context.

virtual ara::core::Result< std::size_t > GetRequiredOutputBufferSize (std::size_t inputSize, bool isFinal) const noexcept;
SetKey دالة 2

Configure the context to use the key stored in the provided KeySlot at the time the encryption is started.

التحميلات الزائدة SetKey 2
virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50086
virtual ara::core::Result< void > SetKey (PublicKey::Sptr key) noexcept=0; SWS_CRYPT_50175
Start دالة

Initialize the context for a new encryption.

virtual ara::core::Result< void > Start () noexcept=0;
Update دالة

Encrypt a data buffer.

virtual ara::core::Result< std::size_t > Update (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

أسماء الأنواع البديلة

Sptr اسم نوع بديل

Smart pointer of the interface.

using Sptr = std::shared_ptr<EncryptorPublicCtx>;

توثيق الدوال

دالة Cancel [SWS_CRYPT_50089] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Cancel () noexcept=0;

Cancel the ongoing streaming operation that has been initiated by Start() and has not yet been finished.

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

تُلغي الطريقة Cancel() عملية دفق نشطة في السياق ara::crypto::cryp::EncryptorPublicCtx، والتي بدأت مسبقًا بواسطة Start() ولم تنتهِ بعد [SWS_CRYPT_50089]. لا تقبل أي معلمات تمرير وتُرجع ara::core::Result<void>، والذي يكون فارغًا في حالة النجاح [SWS_CRYPT_50089]. نظرًا لأن البصمة توفر Result مباشرةً وليس Future، فمن المرجح أن يتم تنفيذ الإلغاء بشكل متزامن. سؤال Q-cd18e56d693fe1a4 (مفتوح)

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

إذا لم تبدأ معالجة البيانات مسبقًا بواسطة Start()، تفشل العملية برمز الخطأ ara::crypto::CryptoErrc::kProcessingNotStarted مع الالتزام بدلالة التراجع [SWS_CRYPT_50089]. وفقًا للمواصفة، صُرح عن الواجهة بـ noexcept، وهي آمنة من حيث الاستثناءات (exception safe) ومصنفة للوصول المتزامن بأنها آمنة مؤشريًا (thread-safe) [SWS_CRYPT_50089].

التفاعل المشترك في حزمة التشفير

يتبع سلوك الإلغاء المحقق بواسطة Cancel() نمط تصميم موحد لعمليات الدفق ذات الحالة في وحدة التشفير. توجد واجهات مماثلة ذات دلالة أخطاء متطابقة لكل من:

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

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

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result if the ongoing streaming operation was cancelled successfully, or a result containing an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if data processing was not started by a call of the Start() method

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50089
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50089@rel:R25-11#a67438e3
Content hash
a67438e3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50089
Status: valid/unmigrated Version: rel:R25-11#e205d10b 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_CRYPT_50089@rel:R25-11#e205d10b
Point-in-Time History:
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

دالة Encrypt [SWS_CRYPT_50090] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > Encrypt (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

Encrypt data in a single-call.

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

تُستخدم الطريقة المتزامنة Encrypt لتشفير بيانات النص الصريح في استدعاء واحد ([SWS_CRYPT_50090]). وهي تأخذ بيانات الإدخال من المخزن المؤقت in (ReadOnlyMemRegion) وتكتب النص المشفر في مخزن الإخراج المؤقت out (ReadWriteMemRegion) ([SWS_CRYPT_50090]). تُرجع قيمة الإرجاع ara::core::Result<std::size_t> في حالة النجاح حجم بيانات الإخراج المكتوبة فعليًا، والتي يمكن أن تكون أصغر من السعة الإجمالية لـ out ([SWS_CRYPT_50090]).

فيما يتعلق بالتزامن، تم تحديد الدالة على أنها آمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe) ([SWS_CRYPT_50090]).

بالتفاعل مع السياق EncryptorPublicCtx، يجب مراعاة حدود المخزن المؤقت التالية قبل الاستدعاء:

  • يجب أن يكون حجم الإدخال ضمن الحدود المحددة بواسطة [SWS_CRYPT_50178] (GetMinimumChunkSize) و[SWS_CRYPT_50091] (GetMaximumChunkSize).
  • يمكن حساب الحد الأقصى المطلوب لسعة مخزن الإخراج المؤقت out مسبقًا عبر GetRequiredOutputBufferSize باستخدام المعامل isFinal = true ([SWS_CRYPT_50177]).

تمتلك جميع حالات الخطأ دلالات تراجع ([SWS_CRYPT_50090]). وتشمل الأخطاء المحددة من ara::crypto::CryptoErrc ما يلي:

  • kUninitializedContext: لم تتم تهيئة السياق من خلال توفير مفتاح ([SWS_CRYPT_50090]).
  • kEmptyKeySlot: إن KeySlot الذي تم تكوينه فارغ ([SWS_CRYPT_50090]).
  • kIncompatibleObject: نوع المفتاح لا يتطابق مع التحويل ([SWS_CRYPT_50090]).
  • kUsageViolation: لا يسمح استخدام المفتاح بتشفير البيانات (kAllowDataEncryption) ([SWS_CRYPT_50090]).
  • kInsufficientCapacity: المخزن المؤقت out صغير جدًا ([SWS_CRYPT_50090]).
  • kInvalidInputSize أو kInvalidArgument: حجم الإدخال غير قابل للمعالجة أو أن بيانات الإدخال غير صالحة ([SWS_CRYPT_50090]).
  • kUnsupported: التشفير عبر استدعاء واحد (Single-Call) غير مدعوم ([SWS_CRYPT_50090]).
  • kBusyResource: أحد الموارد المطلوبة مشغول ([SWS_CRYPT_50090]).

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

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

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing the plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that the encrypted data is written to

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if single-call encryption is not supported
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50090
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50090@rel:R25-11#af058309
Content hash
af058309
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50090
Status: valid/unmigrated Version: rel:R25-11#6de65ef2 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_CRYPT_50090@rel:R25-11#6de65ef2
Point-in-Time History:
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

دالة Finish [SWS_CRYPT_50088] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > Finish (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

Finalize the encryption.

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

الاستخدام

تُكمل الطريقة Finish عملية التشفير غير المتناظر في سياق ara::crypto::cryp::EncryptorPublicCtx [SWS_CRYPT_50088]. يتم الاستدعاء بشكل متزامن وهو محدد كـ noexcept، وآمن من الاستثناءات، وآمن بالنسبة للخيوط. كمعامل، تتولى الدالة عبر in (ReadOnlyMemRegion) الجزء النهائي من النص الصريح وتكتب بيانات النص المشفر الناتجة في المخزن المؤقت للإخراج out (ReadWriteMemRegion). يمكن تحديد حجم المخزن المؤقت المطلوب لـ out مسبقًا عبر GetRequiredOutputBufferSize(). تُرجع قيمة الإرجاع ara::core::Result<std::size_t> في حالة النجاح عدد البايتات المكتوبة فعليًا، والتي يمكن أن تكون أصغر من السعة الإجمالية لمخزن الإخراج المؤقت [SWS_CRYPT_50088].

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

تمتلك جميع حالات الخطأ دلالات تراجع، بحيث تظل حالة السياق متسقة عند حدوث فشل [SWS_CRYPT_50088]. تبلغ الطريقة عن رموز الأخطاء المحددة التالية من ara::crypto::CryptoErrc:

  • kProcessingNotStarted: لم تبدأ معالجة البيانات مسبقًا بواسطة استدعاء Start().
  • kInsufficientCapacity: مخزن الإخراج المؤقت المقدم out صغير الحجم للغاية.
  • kInvalidInputSize: لا يمكن للسياق معالجة حجم المخزن المؤقت لـ in.
  • kInvalidArgument: تحتوي بيانات الإدخال المُمرَّرة على قيم غير صالحة.
  • kUnsupported: معالجة التدفق غير مدعومة من قِبل السياق الفعلي.

تفاعل

يختتم الإنهاء تسلسل المعالجة التشفيرية [SWS_CRYPT_50088]. ويعمل DecryptorPrivateCtx::Finish كعنصر مكمل لفك التشفير [SWS_CRYPT_50068]، بينما يوفر SymmetricCipherCtx::Finish [SWS_CRYPT_50045] نمط تسلسل مماثلًا في مجال التشفير المتناظر.

تم إنشاء هذا النص بواسطة إجراء ذكاء اصطناعي بناءً على المواصفات.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing a part of the plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that contains encrypted data. The required size of this buffer can be queried using GetRequiredOutputBuffer Size()

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if data processing was not started by a call of the Start() method
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if stream processing is not supported by the context

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50088
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50088@rel:R25-11#692dc2b1
Content hash
692dc2b1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50088
Status: valid/unmigrated Version: rel:R25-11#3b39f5a6 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_CRYPT_50088@rel:R25-11#3b39f5a6
Point-in-Time History:
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

دالة GetMaximumChunkSize [SWS_CRYPT_50091] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMaximumChunkSize () const noexcept=0;

Get the maximum input buffer size supported for processing in single calls to Update(), Finish(), or Encrypt() by this context.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >the maximum buffer size in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50091
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50091@rel:R25-11#cc696523
Content hash
cc696523
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50091
Status: valid/unmigrated Version: rel:R25-11#45b93821 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_CRYPT_50091@rel:R25-11#45b93821
Point-in-Time History:
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

دالة GetMinimumChunkSize [SWS_CRYPT_50178] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMinimumChunkSize () const noexcept=0;

Get the minimum input buffer size supported for processing in single calls to Update(), Finish(), or Encrypt() by this context.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >the minimum buffer size in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50178
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50178@rel:R25-11#1402a5af
Content hash
1402a5af
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50178
Status: valid/unmigrated Version: rel:R25-11#96524bdd 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_CRYPT_50178@rel:R25-11#96524bdd
Point-in-Time History:
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

دالة GetRequiredOutputBufferSize [SWS_CRYPT_50177] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > GetRequiredOutputBufferSize (std::size_t inputSize, bool isFinal) const noexcept;

Calculate the maximum required size of the output buffer depending on the input size in the current state of the context.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inputSizesize of input data
isFinalif true, calculate maximum required output buffer size for Finish() or Encrypt(), otherwise for Update()

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the required capacity of the output buffer (in bytes) or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key and setting the transformation direction

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50177
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50177@rel:R25-11#00cc282e
Content hash
00cc282e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50177
Status: valid/unmigrated Version: rel:R25-11#7b76dbd4 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_CRYPT_50177@rel:R25-11#7b76dbd4
Point-in-Time History:
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

دالة SetKey [SWS_CRYPT_50086] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0;

Configure the context to use the key stored in the provided KeySlot at the time the encryption is started.

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

الاستخدام وسياق الاستدعاء

تُستخدم الطريقة الافتراضية الصرفة SetKey للواجهة ara::crypto::cryp::EncryptorPublicCtx (ملف الرأس ara/crypto/cryp/encryptor_public_ctx.h) لتعيين مفتاح لعمليات التشفير غير المتناظر [SWS_CRYPT_50086]. ويتم تمرير مؤشر ذكي keySlot من النوع KeySlot::Sptr كمعامل، والذي يجب أن يحتوي على PublicKey [SWS_CRYPT_50086]. يتم الاستدعاء بشكل متزامن ويشير إلى النجاح عبر ara::core::Result<void> فارغ. من الأمور الأساسية للدلالات أن المفتاح المخزن في الفتحة لا يُستخدم إلا في الوقت الذي يبدأ فيه التشفير [SWS_CRYPT_50086]. (تفسير: بما أن تحليل المفتاح لا يتم إلا مع بدء التشفير الفعلي، يُرجَّح أن التحديثات على محتوى الفتحة قبل وقت البدء هذا تظل سارية المفعول). سؤال Q-25c5d462aafde8a1 (مفتوح)

معالجة الأخطاء

إذا فشلت التهيئة، يتم إرجاع رمز خطأ بدلالات تراجع في كائن النتيجة [SWS_CRYPT_50086]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: يتم الإبلاغ عنه إذا كان keySlot المقدم غير متوافق مع هذا السياق [SWS_CRYPT_50086].
  • ara::crypto::CryptoErrc::kUnsupported: يحدث إذا كان تنفيذ السياق الفعلي يدعم حصريًا الضبط المباشر لـ PublicKey ولا يسمح بربط المفتاح عبر KeySlot [SWS_CRYPT_50086].

التزامن والتفاعل

تم الإعلان عن العملية كـ noexcept، وهي محددة كآمنة من الاستثناءات (exception safe) وآمنة بالنسبة للخيوط (thread-safe) للاستخدام المتزامن [SWS_CRYPT_50086].

يتوفر مفهوم الإسناد غير المباشر للمفاتيح عبر KeySlot بطريقة مماثلة في سياقات غير متناظرة أخرى أيضًا، مثل VerifierPublicCtx::SetKey [SWS_CRYPT_50018] وKeyEncapsulatorPublicCtx::SetKey [SWS_CRYPT_50012]. وهو يختلف عن الطرق التي تقبل كائنات المفاتيح مباشرةً، كما هو الحال على سبيل المثال في [SWS_CRYPT_24115] أو [SWS_CRYPT_21815].

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

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

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keySlota keyslot containing a PublicKey.

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided keyslot is incompatible with this context
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a PublicKey

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50086
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50086@rel:R25-11#79a9f07e
Content hash
79a9f07e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50086
Status: valid/unmigrated Version: rel:R25-11#bd5ede4d 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_CRYPT_50086@rel:R25-11#bd5ede4d
Point-in-Time History:
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

دالة SetKey [SWS_CRYPT_50175] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (PublicKey::Sptr key) noexcept=0;

Configure the context to use the provided key.

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

الاستخدام

تقوم الطريقة الافتراضية SetKey للفئة ara::crypto::cryp::EncryptorPublicCtx بتهيئة السياق لاستخدام مفتاح عام مقدم [SWS_CRYPT_50175].\nعبر المعلمة key (من النوع PublicKey::Sptr)، يتم تمرير كائن المفتاح المراد استخدامه للتشفير [SWS_CRYPT_50175].\nيتم التنفيذ بشكل متزامن ويُرجع ara::core::Result<void>، والذي لا يحتوي على أي قيمة في حالة النجاح [SWS_CRYPT_50175].

معالجة الأخطاء

إذا حدث خطأ أثناء التهيئة، يتم الإبلاغ عن رمز خطأ مطابق بدلالات تراجع محددة [SWS_CRYPT_50175]:

  • ara::crypto::CryptoErrc::kUsageViolation: الاستخدام المسموح به للمفتاح لا يتيح تشفير البيانات (kAllowDataEncryption) [SWS_CRYPT_50175].
  • ara::crypto::CryptoErrc::kIncompatibleObject: كائن المفتاح الذي تم تمريره غير متوافق مع سياق التشفير هذا [SWS_CRYPT_50175].
  • ara::crypto::CryptoErrc::kUnsupported: يدعم التنفيذ الفعلي للسياق حصريًا الربط عبر KeySlot [SWS_CRYPT_50175].

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

تم تعريف الواجهة كـ noexcept وتحدد سلوكًا يكون thread-safe وكذلك exception safe [SWS_CRYPT_50175].\nبفضل دلالات التراجع، يظل السياق في حالته السابقة في حالة حدوث خطأ.\nتفسير: من المحتمل أن يكون الاستدعاء الناجح شرطًا إلزاميًا لعمليات التشفير اللاحقة، حيث لا يمكن للسياق تنفيذ عمليات بدون مفتاح معين. سؤال Q-ab4779cac18793fa (مفتوح)

تفاعل

يتبع هذا الإجراء النمط على مستوى الوحدة للسياقات غير المتماثلة، كما يُستخدم أيضًا في VerifierPublicCtx::SetKey [SWS_CRYPT_24115] وKeyEncapsulatorPublicCtx::SetKey [SWS_CRYPT_21815] لربط المفاتيح.\nبدلاً من ذلك، تنص الواجهات ذات الصلة للتهيئة أيضًا على متغيرات KeySlot، كما هو الحال مثلاً مع VerifierPublicCtx [SWS_CRYPT_50018] أو KeyEncapsulatorPublicCtx [SWS_CRYPT_50012].

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

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

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keythe PublicKey to be used for encryption

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a KeySlot
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided key object is incompatible with this context
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50175
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50175@rel:R25-11#6dd99a90
Content hash
6dd99a90
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50175
Status: valid/unmigrated Version: rel:R25-11#52d22e05 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_CRYPT_50175@rel:R25-11#52d22e05
Point-in-Time History:
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

دالة Start [SWS_CRYPT_50087] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Start () noexcept=0;

Initialize the context for a new encryption.

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

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

تُستخدم الطريقة الافتراضية الصرفة Start للفئة ara::crypto::cryp::EncryptorPublicCtx لتهيئة السياق لتشفير جديد [SWS_CRYPT_50087]. ولا تقبل أي معاملات تمرير ويتم تنفيذها بشكل متزامن. كقيمة إرجاع، تُرجع الدالة ara::core::Result<void>، والتي إما تؤكد التهيئة الناجحة أو تنقل رمز خطأ حدث [SWS_CRYPT_50087].

معالجة الأخطاء وسلوك التراجع

إذا لم تكن الشروط المسبقة المطلوبة لعملية التشفير مستوفاة، يفشل الاستدعاء. تضمن المواصفة دلالات تراجع لحالات الخطأ وتحدد أسباب الخطأ التالية [SWS_CRYPT_50087]:

  • UninitializedContext: لم يتم تعيين مفتاح للسياق مسبقًا.
  • ara::crypto::CryptoErrc::kEmptyKeySlot: إن KeySlot مهيأ غير مشغول حاليًا.
  • ara::crypto::CryptoErrc::kUsageViolation: لا تتضمن أذونات المفتاح راية الاستخدام kAllowDataEncryption.
  • ara::crypto::CryptoErrc::kIncompatibleObject: نوع المفتاح المعيّن غير متوافق مع التحويل المطلوب.
  • ara::crypto::CryptoErrc::kBusyResource: أحد الموارد المطلوبة للتهيئة مشغول.
  • ara::crypto::CryptoErrc::kUnsupported: معالجة التدفق غير مدعومة من قِبل السياق الفعلي.

التزامن والتفاعل

تم تحديد الطريقة كـ thread-safe وexception safe [SWS_CRYPT_50087]. يُعد توفير مفتاح مناسب في السياق شرطًا إلزاميًا للنجاح. ومن الناحية المفاهيمية، تندمج الدالة في دورات الحياة القياسية للسياقات التشفيرية، حيث يتم إعداد العمليات عبر استدعاءات خالية من المعاملات — بشكل مشابه للتحقق من التوقيعات [SWS_CRYPT_50019]، أو توليد التوقيعات [SWS_CRYPT_50037]، أو حسابات MAC [SWS_CRYPT_22111]. ويُرجَّح أن يمثل الاستدعاء نقطة البداية الإلزامية قبل التنفيذ الفعلي لتشفير التدفق. سؤال Q-db262c3914e6b4cf (مفتوح)

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

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

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe ara::crypto::CryptoErrc::k rollback_semantics

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
UninitializedContextif the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if stream processing is not supported by the context

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50087
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50087@rel:R25-11#02827b1d
Content hash
02827b1d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50087
Status: valid/unmigrated Version: rel:R25-11#d8c9987f 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_CRYPT_50087@rel:R25-11#d8c9987f
Point-in-Time History:
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

دالة Update [SWS_CRYPT_50176] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > Update (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

Encrypt a data buffer.

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

الاستخدام

تُستخدم الطريقة المتزامنة Update للفئة ara::crypto::cryp::EncryptorPublicCtx للتشفير التدريجي لكتل بيانات نص عادي [SWS_CRYPT_50176]. عبر المعلمة in (ReadOnlyMemRegion) يتم تمرير جزء من النص العادي، بينما تُكتب البيانات المشفرة في المخزن المؤقت للإخراج out (ReadWriteMemRegion) [SWS_CRYPT_50176]. كقيمة إرجاع، تقدم الدالة عبر ara::core::Result<std::size_t> العدد الفعلي للبايتات المكتوبة، والتي يمكن أن تكون أصغر من السعة المتوفرة لـ out [SWS_CRYPT_50176].

التسلسل والتفاعل

قبل الاستدعاء الأول لـ Update، يجب بالضرورة بدء معالجة البيانات بواسطة Start() [SWS_CRYPT_50176]. يمكن الاستعلام عن الحد الأقصى المسموح به لحجم الإدخال للاستدعاءات الفردية عبر الطريقة GetMaximumChunkSize() [SWS_CRYPT_50091]. بالإضافة إلى ذلك، يمكن حساب الحجم الأدنى المطلوب لـ out عبر GetRequiredOutputBufferSize() [SWS_CRYPT_50176].

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

إذا حدث خطأ أثناء التنفيذ، يتم الإبلاغ عنه بدلالات التراجع [SWS_CRYPT_50176]:

  • ara::crypto::CryptoErrc::kProcessingNotStarted: لم تبدأ معالجة البيانات مسبقًا باستخدام Start() [SWS_CRYPT_50176].
  • ara::crypto::CryptoErrc::kInsufficientCapacity: سعة المخزن المؤقت out غير كافية للنتيجة [SWS_CRYPT_50176].
  • ara::crypto::CryptoErrc::kInvalidInputSize: حجم المخزن المؤقت لـ in غير صالح [SWS_CRYPT_50176].
  • ara::crypto::CryptoErrc::kUnsupported: معالجة الدفق غير مدعومة بواسطة السياق الحالي [SWS_CRYPT_50176].

تم التصريح عن الطريقة على أنها آمنة من الاستثناءات وآمنة خيطيًا [SWS_CRYPT_50176]. ومع ذلك، من المحتمل أن يتطلب الاستدعاء المتوازي لعدة عمليات على نفس كائن السياق مزامنة خارجية لضمان ترتيب حتمي لأجزاء البيانات المشفرة. سؤال Q-b22ffe505b583b25 (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو بمثابة دليل توجيهي. المواصفة هي المرجع الملزم.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing a part of the plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that the encrypted data will be written into. The required size of this buffer can be queried using GetRequired OutputBufferSize()

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if data processing was not started by a call of the Start() method
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer is invalid
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if stream processing is not supported by the context

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50176
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50176@rel:R25-11#0938968b
Content hash
0938968b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50176
Status: valid/unmigrated Version: rel:R25-11#89552c35 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_CRYPT_50176@rel:R25-11#89552c35
Point-in-Time History:
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

توثيق أسماء الأنواع البديلة

اسم نوع بديل Sptr [SWS_CRYPT_50174] Upstream: RS_CRYPTO_02201

using Sptr = std::shared_ptr<EncryptorPublicCtx>;

Smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/encryptor_public_ctx.h"
Scopeclass ara::crypto::cryp::EncryptorPublicCtx
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50174
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50174@rel:R25-11#252f1e7a
Content hash
252f1e7a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50174
Status: valid/unmigrated Version: rel:R25-11#e0ee55ea 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_CRYPT_50174@rel:R25-11#e0ee55ea
Point-in-Time History:
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