مرجع ساختار SuplCertificateInterface
#include < gps.h >
فیلدهای داده | |
| اندازه_t | اندازه |
| int(* | install_certificates )(const DerEncodedCertificate *گواهینامه ها، اندازه_t طول) |
| int(* | revoke_certificates )(const Sha1CertificateFingerprint *اثرانگشت، اندازه_t طول) |
توصیف همراه با جزئیات
مستندات میدانی
| int(* install_certificates)(const DerEncodedCertificate *گواهینامه ها، اندازه_t طول) |
مجموعه ای از گواهی های مورد استفاده برای اتصالات 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 *انگشت، اندازه_t طول) |
به HAL اطلاع می دهد که لیستی از گواهی های استفاده شده برای اتصالات SUPL باطل شده است. انتظار می رود مجموعه گواهی های داده شده از فروشگاه داخلی HAL حذف شود.
پارامترها: اثر انگشت - اشاره‌گر به آرایه‌ای از اثر انگشت SHA1 برای شناسایی مجموعه گواهی‌هایی که باید باطل شوند. طول - تعداد اثر انگشت ارائه شده. اگر عملیات با موفقیت تکمیل شود، برمی‌گرداند: AGPS_CERTIFICATE_OPERATION_SUCCESS.
مهم: اگر هر یک از گواهی های ارائه شده (از طریق اثر انگشت آن) توسط HAL شناخته نشده است، باید نادیده گرفته شود و به لغو/حذف بقیه آنها ادامه دهید.
مستندات این ساختار از فایل زیر تولید شده است:
- hardware/libhardware/include/hardware/ gps.h