SuplCertificateInterface 结构体参考文档

SuplCertificateInterface 结构体参考文档

#include < gps.h >

数据字段

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

详细说明

用于处理 SUPL 证书操作的 AGPS 接口

定义位于文件 gps.h 978 行。

字段文档

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

安装用于与 AGPS 服务器建立 SUPL 连接的一组证书。如有需要,HAL 应在内部查找需要移除的所有证书,以便安装证书。安装的证书代表连接到 AGPS SUPL 服务器所需的完整有效证书。在尝试与 AGPS 服务器建立连接时,必须提供证书列表,并且所有证书都必须同时可用。

参数:certificates - 指向需要安装在 HAL 中的 DER 编码证书数组的指针。length - 要安装的证书数量。返回值:如果操作成功完成,则返回 AGPS_CERTIFICATE_OPERATION_SUCCESS;如果 HAL 无法存储尝试安装的证书数量,则返回 AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES;在这种错误情况下,存储的证书的状态应与之前保持不变。

重要提示:如有必要,HAL 应在内部找出需要移除的一组证书,以便安装要安装的证书。

定义位于文件 gps.h 1005 行中。

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

通知 HAL 用于 SUPL 连接的证书列表已被撤消。预计系统会从 HAL 的内部存储区中移除指定的一组证书。

参数:fingerprints - 指向 SHA1 指纹数组的指针,用于标识要撤消的一组证书。length - 提供的指纹数量。返回值:如果操作成功完成,则返回 AGPS_CERTIFICATE_OPERATION_SUCCESS。

重要提示:如果 HAL 不认识提供的任何证书(通过其指纹),则应忽略该证书,并继续撤消/删除其余证书。

定义位于文件 gps.h 1022 行中。

size_t size

设置为 sizeof(SuplCertificateInterface)

定义位于文件 gps.h 980 行。


此结构体的文档是根据以下文件生成的:
  • hardware/libhardware/include/hardware/ gps.h