Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release
thay vì aosp-main
để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tham chiếu cấu trúc SuplCertificateInterface
#include <
gps.h
>
Giao diện AGPS để xử lý các thao tác chứng chỉ SUPL
Định nghĩa tại dòng
978
của tệp
gps.h
.
Cài đặt một bộ Chứng chỉ dùng cho các kết nối SUPL với máy chủ AGPS. Nếu cần, HAL sẽ tìm ra mọi chứng chỉ cần xoá để phù hợp với các chứng chỉ cần cài đặt. Các chứng chỉ đã cài đặt đại diện cho một bộ chứng chỉ hợp lệ đầy đủ cần thiết để kết nối với máy chủ AGPS SUPL. Danh sách chứng chỉ là bắt buộc và tất cả chứng chỉ phải có sẵn cùng một lúc khi cố gắng thiết lập kết nối với Máy chủ AGPS.
Tham số: certificates – Con trỏ đến một mảng các chứng chỉ được mã hoá DER cần được cài đặt trong HAL. length – Số lượng chứng chỉ cần cài đặt. Trả về: AGPS_CERTIFICATE_OPERATION_SUCCESS nếu thao tác hoàn tất thành công AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES nếu HAL không thể lưu trữ số lượng chứng chỉ đã cố gắng cài đặt, trạng thái của các chứng chỉ được lưu trữ sẽ vẫn giữ nguyên như trước trong trường hợp lỗi này.
QUAN TRỌNG: Nếu cần, HAL phải tìm ra bộ chứng chỉ cần xoá để phù hợp với các chứng chỉ cần cài đặt.
Định nghĩa tại dòng
1005
của tệp
gps.h
.
Thông báo cho HAL rằng danh sách chứng chỉ dùng cho các kết nối SUPL đã bị thu hồi. Dự kiến, nhóm chứng chỉ đã cho sẽ bị xoá khỏi kho lưu trữ nội bộ của HAL.
Tham số: fingerprints – Con trỏ đến một mảng gồm các vân tay số SHA1 để xác định tập hợp chứng chỉ cần thu hồi. length – Số lượng vân tay số được cung cấp. Trả về: AGPS_CERTIFICATE_OPERATION_SUCCESS nếu thao tác hoàn tất thành công.
QUAN TRỌNG: Nếu HAL không biết bất kỳ chứng chỉ nào được cung cấp (thông qua vân tay số), thì bạn nên bỏ qua chứng chỉ đó và tiếp tục thu hồi/xoá các chứng chỉ còn lại.
Định nghĩa tại dòng
1022
của tệp
gps.h
.
đặt thành sizeof(SuplCertificateInterface)
Định nghĩa tại dòng
980
của tệp
gps.h
.
Tài liệu cho cấu trúc này được tạo từ tệp sau:
-
hardware/libhardware/include/hardware/
gps.h
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],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)"]]