از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مرجع ساختار SuplCertificateInterface
#include < gps.h >
رابط AGPS برای رسیدگی به عملیات گواهی SUPL
تعریف در خط 978 فایل gps.h.
مجموعه ای از گواهی های مورد استفاده برای اتصالات SUPL به سرور AGPS را نصب می کند. در صورت نیاز، HAL باید هر گونه گواهی را که باید حذف شود تا گواهینامه‌ها را نصب کند، در داخل پیدا کند. گواهی‌های نصب‌شده مجموعه کاملی از گواهی‌های معتبر مورد نیاز برای اتصال به سرورهای AGPS SUPL را نشان می‌دهند. هنگام تلاش برای برقراری ارتباط با سرور AGPS، لیست گواهی ها مورد نیاز است و همه باید همزمان در دسترس باشند.
پارامترها: گواهینامه ها - اشاره گر به آرایه ای از گواهینامه های رمزگذاری شده DER که باید در HAL نصب شوند. طول - تعداد گواهی برای نصب. برمی‌گرداند: AGPS_CERTIFICATE_OPERATION_SUCCESS اگر عملیات با موفقیت کامل شود AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES اگر HAL نتواند تعداد گواهی‌هایی را که برای نصب تلاش کرده‌اند ذخیره کند، وضعیت گواهی‌های ذخیره‌شده باید مانند قبل در این مورد خطا باقی بماند.
مهم: در صورت نیاز، HAL باید به صورت داخلی مجموعه گواهی‌هایی را که باید حذف شوند تا گواهی‌ها را نصب کنند، بیابد.
تعریف در خط 1005 فایل gps.h.
به HAL اطلاع می دهد که لیستی از گواهی های استفاده شده برای اتصالات SUPL باطل شده است. انتظار می رود مجموعه گواهی های داده شده از فروشگاه داخلی HAL حذف شود.
پارامترها: اثر انگشت - اشاره‌گر به آرایه‌ای از اثر انگشت SHA1 برای شناسایی مجموعه گواهی‌هایی که باید باطل شوند. طول - تعداد اثر انگشت ارائه شده. اگر عملیات با موفقیت تکمیل شود، برمی‌گرداند: AGPS_CERTIFICATE_OPERATION_SUCCESS.
مهم: اگر هر یک از گواهی های ارائه شده (از طریق اثر انگشت آن) توسط HAL شناخته نشده است، باید نادیده گرفته شود و به لغو/حذف بقیه آنها ادامه دهید.
تعریف در خط 1022 فایل gps.h.
تنظیم روی sizeof (SuplCertificateInterface)
تعریف در خط 980 فایل gps.h.
مستندات این ساختار از فایل زیر تولید شده است:
- hardware/libhardware/include/hardware/ gps.h
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Android Hardware Abstraction Layer: SuplCertificateInterface Struct Reference\n\nSuplCertificateInterface Struct Reference\n=========================================\n\n[Data Fields](#pub-attribs) \nSuplCertificateInterface Struct Reference \n\n`\n#include \u003c\n`[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)`\n\u003e\n`\n\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data Fields ----------- ||\n| size_t | [size](/reference/hal/struct_supl_certificate_interface#a854352f53b148adc24983a58a1866d66) |\n| ||\n| int(\\* | [install_certificates](/reference/hal/struct_supl_certificate_interface#a9208ffa455b013091db3afa2abc2a1a3) )(const [DerEncodedCertificate](/reference/hal/struct_der_encoded_certificate) \\*certificates, size_t length) |\n| ||\n| int(\\* | [revoke_certificates](/reference/hal/struct_supl_certificate_interface#a6c541c29aa9f7a5fb5f44ce4283e98e3) )(const [Sha1CertificateFingerprint](/reference/hal/struct_sha1_certificate_fingerprint) \\*fingerprints, size_t length) |\n| ||\n\n\nDetailed Description\n--------------------\n\n\nAGPS Interface to handle SUPL certificate operations\n\n\nDefinition at line\n[978](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\nField Documentation\n-------------------\n\n\n|------------------------------------------------------------------------------------------------------------------------------------------|\n| int(\\* install_certificates)(const [DerEncodedCertificate](/reference/hal/struct_der_encoded_certificate) \\*certificates, size_t length) |\n\n\nInstalls a set of Certificates used for SUPL connections to the AGPS server. If needed the HAL should find out internally any certificates that need to be removed to accommodate the certificates to install. The certificates installed represent a full set of valid certificates needed to connect to AGPS SUPL servers. The list of certificates is required, and all must be available at the same time, when trying to establish a connection with the AGPS Server.\n\n\nParameters: certificates - A pointer to an array of DER encoded certificates that are need to be installed in the HAL. length - The number of certificates to install. Returns: AGPS_CERTIFICATE_OPERATION_SUCCESS if the operation is completed successfully AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES if the HAL cannot store the number of certificates attempted to be installed, the state of the certificates stored should remain the same as before on this error case.\n\n\nIMPORTANT: If needed the HAL should find out internally the set of certificates that need to be removed to accommodate the certificates to install.\n\n\nDefinition at line\n[1005](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| int(\\* revoke_certificates)(const [Sha1CertificateFingerprint](/reference/hal/struct_sha1_certificate_fingerprint) \\*fingerprints, size_t length) |\n\n\nNotifies the HAL that a list of certificates used for SUPL connections are revoked. It is expected that the given set of certificates is removed from the internal store of the HAL.\n\n\nParameters: fingerprints - A pointer to an array of SHA1 Fingerprints to identify the set of certificates to revoke. length - The number of fingerprints provided. Returns: AGPS_CERTIFICATE_OPERATION_SUCCESS if the operation is completed successfully.\n\n\nIMPORTANT: If any of the certificates provided (through its fingerprint) is not known by the HAL, it should be ignored and continue revoking/deleting the rest of them.\n\n\nDefinition at line\n[1022](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n|-------------|\n| size_t size |\n\n\nset to sizeof(SuplCertificateInterface)\n\n\nDefinition at line\n[980](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n*** ** * ** ***\n\nThe documentation for this struct was generated from the following file:\n\n- hardware/libhardware/include/hardware/ [gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)"]]
