通用查询介绍及规格
HUKS提供属性查询接口,支持从外部密钥管理执行通用查询操作,例如Ukey设备信息、PIN码信息等。
- OH_Huks_GetProperty接口和getProperty接口的resourceId是提供者的资源ID,用于标识要查询的远程资源,长度必须介于1-1024字节。接口的属性ID采用定义在 GMT 0016-2023 标准中的SKF函数名称,长度必须介于 1-100 字节。
- 输出参数通过HUKS_EXT_CRYPTO_TAG_EXTRA_DATA携带,应用可以提取该查询出的属性数据,并按照和驱动应用(外部密钥管理扩展能力提供方)的约定,解析数据。
支持的属性函数名称(示例)
下列为部分属性函数名称示例,供实现方参考(更多详细且权威的函数名请参考 GMT 0016-2023 标准):
| 函数名 | 说明 |
|---|---|
| SKF_GetDevInfo | 获取设备信息。 |
| SKF_EnumDev | 枚举设备。 |
| SKF_EnumContainer | 枚举容器。 |
| SKF_EnumApplication | 枚举应用。 |
实际实现应与 GMT 0016-2023 中规定的函数名保持一致。各方(调用端和CryptoExtension实现)需约定使用的函数名集合及其参数/返回格式。