SuplCertificateInterface 結構體參考資料

資料欄位
SuplCertificateInterface 結構體參考資料

#include < gps.h >

資料欄位

size_t  size
 
int(*  install_certificates )(const DerEncodedCertificate *certificates, size_t length)
 
int(*  revoke_certificates )(const Sha1CertificateFingerprint *fingerprints, size_t length)
 

詳細說明

AGPS 介面，用於處理 SUPL 憑證作業

定義位於檔案 gps.h 的 978 行。

欄位說明文件

int(* install_certificates)(const DerEncodedCertificate *certificates, size_t length)

安裝一組用於 SUPL 連線至 A-GPS 伺服器的憑證。如有需要，HAL 應在內部找出需要移除的憑證，以便安裝憑證。安裝的憑證代表連線至 AGPS SUPL 伺服器所需的完整有效憑證組合。嘗試與 AGPS 伺服器建立連線時，必須提供憑證清單，且所有憑證都必須同時可用。

參數：certificates - 指向 DER 編碼憑證陣列的指標，這些憑證需要在 HAL 中安裝。length - 要安裝的憑證數量。傳回值：如果作業順利完成，則傳回 AGPS_CERTIFICATE_OPERATION_SUCCESS；如果 HAL 無法儲存嘗試安裝的憑證數量，則傳回 AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES；如果儲存的憑證狀態與此錯誤案例中的狀態相同，則傳回 AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES。

重要事項：如有需要，HAL 應在內部找出需要移除的憑證組合，以便安裝憑證。

定義位於檔案 gps.h 的 1005 行。

int(* revoke_certificates)(const Sha1CertificateFingerprint *fingerprints, size_t length)

通知 HAL，已撤銷用於 SUPL 連線的憑證清單。系統會從 HAL 的內部儲存庫中移除指定的憑證組合。

參數：指紋 - 指向 SHA1 指紋陣列的指標，用於識別要撤銷的憑證組合。長度 - 提供的指紋數量。傳回值：如果作業順利完成，則為 AGPS_CERTIFICATE_OPERATION_SUCCESS。

重要事項：如果 HAL 無法辨識透過指紋提供的任何憑證，應忽略該憑證，並繼續撤銷/刪除其餘憑證。

定義位於檔案 gps.h 的 1022 行。

size_t size

設為 sizeof(SuplCertificateInterface)

定義位於檔案 gps.h 的 980 行。

這個結構體的說明文件是由下列檔案產生：
  • hardware/libhardware/include/hardware/ gps.h