X509_NAME_ENTRY_GET_OBJECT(3ssl)

الاسم
X509_NAME_ENTRY_get_object, X509_NAME_ENTRY_get_data, X509_NAME_ENTRY_set_object, X509_NAME_ENTRY_set_data, X509_NAME_ENTRY_create_by_txt, X509_NAME_ENTRY_create_by_NID, X509_NAME_ENTRY_create_by_OBJ - دوال مساعدة X509_NAME_ENTRY

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

 ASN1_OBJECT *X509_NAME_ENTRY_get_object(const X509_NAME_ENTRY *ne);
 ASN1_STRING *X509_NAME_ENTRY_get_data(const X509_NAME_ENTRY *ne);

 int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, const ASN1_OBJECT *obj);
 int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type,
                              const unsigned char *bytes, int len);

 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne, const char *field,
                                                int type, const unsigned char *bytes,
                                                int len);
 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid,
                                                int type, const unsigned char *bytes,
                                                int len);
 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne,
                                                const ASN1_OBJECT *obj, int type,
                                                const unsigned char *bytes, int len);

الوصف
X509_NAME_ENTRY_get_object() يسترجع اسم الحقل لـ ne في بنية ASN1_OBJECT.

X509_NAME_ENTRY_get_data() يسترجع قيمة الحقل لـ ne في بنية ASN1_STRING.

X509_NAME_ENTRY_set_object() يضبط اسم الحقل لـ ne إلى obj.

X509_NAME_ENTRY_set_data() يضبط قيمة الحقل لـ ne إلى نوع سلسلة محارف type وقيمة محددة بواسطة bytes و len.

X509_NAME_ENTRY_create_by_txt() و X509_NAME_ENTRY_create_by_NID() و X509_NAME_ENTRY_create_by_OBJ() تنشئ وتعيد بنية X509_NAME_ENTRY.

ملاحظات
يمكن استخدام X509_NAME_ENTRY_get_object() و X509_NAME_ENTRY_get_data() لفحص دالة X509_NAME_ENTRY كما تُعاد بواسطة X509_NAME_get_entry() على سبيل المثال.

نادرًا ما تُستخدم X509_NAME_ENTRY_create_by_txt() و X509_NAME_ENTRY_create_by_OBJ() و X509_NAME_ENTRY_create_by_NID() و X509_NAME_ENTRY_set_data() عمليًا لأن بنى X509_NAME_ENTRY تكون دائمًا تقريبًا جزءًا من بنى X509_NAME وتُستخدم دوال X509_NAME المقابلة عادةً لإنشاء وإضافة إدخالات جديدة في عملية واحدة.

تدعم معاملات هذه الدوال خيارات مشابهة لتلك المسماة بالمثل لدوال X509_NAME المقابلة مثل X509_NAME_add_entry_by_txt(). لذا على سبيل المثال يمكن ضبط type إلى MBSTRING_ASC ولكن في حالة X509_set_data() يجب ضبط اسم الحقل أولاً ليتم البحث عن معلومات الحقل ذات الصلة داخليًا.

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

تُعيد X509_NAME_ENTRY_get_data() بنية ASN1_STRING صالحة إذا كانت مضبوطة أو NULL إذا حدث خطأ.

تُعيد X509_NAME_ENTRY_set_object() و X509_NAME_ENTRY_set_data() 1 عند النجاح أو 0 عند الخطأ.

تُعيد X509_NAME_ENTRY_create_by_txt() و X509_NAME_ENTRY_create_by_NID() و X509_NAME_ENTRY_create_by_OBJ() بنية X509_NAME_ENTRY صالحة عند النجاح أو NULL إذا حدث خطأ.

انظر أيضًا
ERR_get_error(3), d2i_X509_NAME(3), OBJ_nid2obj(3)

حقوق النسخ
حقوق النشر 2002-2018 مؤلفو مشروع 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.