跳到主要内容

通用查询介绍及规格

HUKS提供属性查询接口,支持从外部密钥管理执行通用查询操作,例如Ukey设备信息、PIN码信息等。

  1. OH_Huks_GetProperty接口和getProperty接口的resourceId是提供者的资源ID,用于标识要查询的远程资源,长度必须介于1-1024字节。接口的属性ID采用定义在 GMT 0016-2023 标准中的SKF函数名称,长度必须介于 1-100 字节。
  2. 输出参数通过HUKS_EXT_CRYPTO_TAG_EXTRA_DATA携带,应用可以提取该查询出的属性数据,并按照和驱动应用(外部密钥管理扩展能力提供方)的约定,解析数据。

支持的属性函数名称(示例)

下列为部分属性函数名称示例,供实现方参考(更多详细且权威的函数名请参考 GMT 0016-2023 标准):

函数名说明
SKF_GetDevInfo获取设备信息。
SKF_EnumDev枚举设备。
SKF_EnumContainer枚举容器。
SKF_EnumApplication枚举应用。

实际实现应与 GMT 0016-2023 中规定的函数名保持一致。各方(调用端和CryptoExtension实现)需约定使用的函数名集合及其参数/返回格式。