مرجع بنية SuplCertificateInterface
#include <
gps.h
>
حقول البيانات |
|
| size_t | size |
| int(* | install_certificates )(const DerEncodedCertificate *certificates, size_t length) |
| int(* | revoke_certificates )(const Sha1CertificateFingerprint *fingerprints, size_t length) |
وصف مفصّل
مستندات الحقل
| int(* install_certificates)(const DerEncodedCertificate *certificates, size_t length) |
تثبيت مجموعة من الشهادات المستخدَمة لاتصالات SUPL بخادم AGPS إذا لزم الأمر، على فريق HAL معرفة أي شهادات يجب إزالتها لتتوافق مع الشهادات المطلوب تثبيتها. تمثل الشهادات المثبَّتة مجموعة كاملة من الشهادات الصالحة اللازمة للاتصال بخوادم AGPS SUPL. يجب توفُّر قائمة الشهادات، ويجب أن تكون جميعها متاحة في الوقت نفسه عند محاولة إنشاء اتصال بخادم AGPS.
المَعلمات: الشهادات: مؤشر إلى صفيف من الشهادات بترميز DER التي يجب تثبيتها في HAL. الطول: عدد الشهادات المطلوب تثبيتها. يتم عرض: AGPS_CERTIFICATE_OPERATION_SUCCESS في حال اكتمال العملية بنجاح، أو AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES في حال تعذّر على HAL تخزين عدد الشهادات التي تمّت محاولة تثبيتها، ويجب أن تظلّ حالة الشهادات المخزّنة كما هي في السابق في حال حدوث هذا الخطأ.
ملاحظة مهمة: إذا لزم الأمر، يجب أن يحدِّد فريق HAL مجموعة الشهادات التي يجب إزالتها لاستيعاب الشهادات المطلوب تثبيتها.
| int(* revoke_certificates)(const Sha1CertificateFingerprint *fingerprints, size_t length) |
إرسال إشعار إلى HAL بأنّه تم إبطال قائمة الشهادات المستخدَمة في عمليات الاتصال عبر SUPL من المتوقّع أن تتم إزالة مجموعة الشهادات المحدّدة من المتجر الداخلي لواجهة HAL.
المَعلمات: بصمات_الأصابع: مؤشر إلى صفيف من ملفات مرجعية SHA1 لتحديد مجموعة الشهادات المطلوب إبطالها. الطول: عدد ملفات المرجعية المقدَّمة. يتم عرض القيمة AGPS_CERTIFICATE_OPERATION_SUCCESS إذا اكتملت العملية بنجاح.
ملاحظة مهمة: إذا لم تكن أي من الشهادات المقدَّمة (من خلال بصمة إصبعها) معروفة لواجهة HAL، يجب تجاهلها ومواصلة إبطال/حذف بقية الشهادات.
تم إنشاء مستندات هذه البنية من الملف التالي:
- hardware/libhardware/include/hardware/ gps.h