התייחסות למבנה SuplCertificateInterface
#include < gps.h >
שדות נתונים | |
size_t | גודל |
int(* | install_certificates )(const DerEncodedCertificate *certificates, size_t length) |
int(* | revoke_certificates )(const Sha1CertificateFingerprint *טביעות אצבע, 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 *טביעות אצבע, size_t length) |
מודיע ל-HAL כי רשימה של אישורים המשמשים עבור חיבורי SUPL בוטלה. צפוי שמערכת האישורים הנתונה תוסר מהמאגר הפנימי של ה-HAL.
פרמטרים: טביעות אצבע - מצביע למערך של טביעות אצבע SHA1 לזיהוי קבוצת האישורים לביטול. אורך - מספר טביעות האצבע שסופקו. מחזירה: AGPS_CERTIFICATE_OPERATION_SUCCESS אם הפעולה הושלמה בהצלחה.
חשוב: אם אחד מהאישורים שסופקו (דרך טביעת האצבע שלו) אינו ידוע על ידי ה-HAL, יש להתעלם ממנו ולהמשיך לבטל/למחוק את שאר האישורים.
התיעוד עבור מבנה זה נוצר מהקובץ הבא:
- hardware/libhardware/include/hardware/ gps.h