CMS_GET1_RECEIPTREQUEST(3ssl)

الاسم
CMS_ReceiptRequest_create0_ex, CMS_ReceiptRequest_create0, CMS_add1_ReceiptRequest, CMS_get1_ReceiptRequest, CMS_ReceiptRequest_get0_values - دوال طلب إيصال موقع CMS

موجز
 #include <openssl/cms.h>

 CMS_ReceiptRequest *CMS_ReceiptRequest_create0_ex(
     unsigned char *id, int idlen, int allorfirst,
     STACK_OF(GENERAL_NAMES) *receiptList, STACK_OF(GENERAL_NAMES) *receiptsTo,
     OSSL_LIB_CTX *libctx);
 CMS_ReceiptRequest *CMS_ReceiptRequest_create0(
     unsigned char *id, int idlen, int allorfirst,
     STACK_OF(GENERAL_NAMES) *receiptList, STACK_OF(GENERAL_NAMES) *receiptsTo);
 int CMS_add1_ReceiptRequest(CMS_SignerInfo *si, CMS_ReceiptRequest *rr);
 int CMS_get1_ReceiptRequest(CMS_SignerInfo *si, CMS_ReceiptRequest **prr);
 void CMS_ReceiptRequest_get0_values(CMS_ReceiptRequest *rr, ASN1_STRING **pcid,
                                     int *pallorfirst,
                                     STACK_OF(GENERAL_NAMES) **plist,
                                     STACK_OF(GENERAL_NAMES) **prto);

الوصف
CMS_ReceiptRequest_create0_ex() تُنشئ بنية طلب إيصال موقع. يُضبط حقل signedContentIdentifier باستخدام id و idlen، أو يُضبط إلى 32 بايت من البيانات العشوائية الزائفة إذا كان id هو NULL. إذا كان receiptList هو NULL، يُستخدم خيار allOrFirstTier في receiptsFrom ويُضبط إلى قيمة المعامل allorfirst. إذا لم يكن receiptList هو NULL، يُستخدم خيار receiptList في receiptsFrom. يُحدد المعامل receiptsTo قيمة حقل receiptsTo. يُستخدم سياق المكتبة libctx للعثور على المولد العشوائي العام.

CMS_ReceiptRequest_create0() مشابهة لـ CMS_ReceiptRequest_create0_ex() لكنها تستخدم قيماً مبدئية NULL لسياق المكتبة libctx.

الدالة CMS_add1_ReceiptRequest() تُضيف طلب إيصال موقع rr إلى بنية SignerInfo si.

int CMS_get1_ReceiptRequest() تبحث عن طلب إيصال موقع في si، إذا وُجد أي منها، يُفك ترميزه ويُكتب إلى prr.

CMS_ReceiptRequest_get0_values() تسترجع قيم طلب إيصال. يُنسخ signedContentIdentifier إلى pcid. إذا استُخدم خيار allOrFirstTier من receiptsFrom، تُنسخ قيمته إلى pallorfirst، وإلا يُنسخ حقل receiptList إلى plist. يُنسخ المعامل receiptsTo إلى prto.

ملاحظات
لمزيد من التفاصيل حول معنى الحقول، انظر RFC2634.

يجب اعتبار محتويات الإيصال الموقع ذات معنى فقط إذا أمكن التحقق من بنية CMS_ContentInfo المقابلة بنجاح باستخدام CMS_verify().

القيم المُرجعة
CMS_ReceiptRequest_create0_ex() و CMS_ReceiptRequest_create0() تُعيدان بنية طلب إيصال موقع أو NULL إذا حدث خطأ.

CMS_add1_ReceiptRequest() تُعيد 1 للنجاح أو 0 إذا حدث خطأ.

CMS_get1_ReceiptRequest() تُعيد 1 إذا وُجد طلب إيصال موقع وفُك ترميزه. تُعيد 0 إذا لم يكن طلب الإيصال الموقع موجوداً و -1 إذا كان موجوداً لكنه مشوه.

انظر أيضًا
ERR_get_error(3), CMS_sign(3), CMS_sign_receipt(3), CMS_verify(3) CMS_verify_receipt(3)

التاريخ
أُضيفت الدالة CMS_ReceiptRequest_create0_ex() في OpenSSL 3.0.

حقوق النسخ
حقوق النشر 2008-2021 مؤلفو مشروع OpenSSL. جميع الحقوق محفوظة.

مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط <https://www.openssl.org/source/license.html>.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.