Tham chiếu cấu trúc SuplCertificateInterface
#include <
gps.h
>
Trường dữ liệu |
|
size_t | size |
int(* | install_certificates )(const DerEncodedCertificate *certificates, size_t length) |
int(* | revoke_certificates )(const Sha1CertificateFingerprint *fingerprints, size_t length) |
Nội dung mô tả chi tiết
Tài liệu về trường
int(* install_certificates)(const DerEncodedCertificate *certificates, size_t length) |
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.
int(* revoke_certificates)(const Sha1CertificateFingerprint *fingerprints, size_t length) |
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.
Tài liệu cho cấu trúc này được tạo từ tệp sau:
- hardware/libhardware/include/hardware/ gps.h