通用查询介绍及规格
=========

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/de/v3/6kpBrL-WTvaqom9fOR9r7Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132429Z&HW-CC-Expire=86400&HW-CC-Sign=5CB644AC3DA0DA0F698721EB886597BA93C3726519F626C53C767A87EC4D8107)

1.  [OH\_Huks\_GetProperty](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-huks-external-crypto-api-h#oh_huks_getproperty)接口和[getProperty](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-huksexternalcrypto#huksexternalcryptogetproperty)接口的resourceId是提供者的资源ID，用于标识要查询的远程资源，长度必须介于1-1024字节。接口的属性ID采用定义在 GMT 0016-2023 标准中的SKF函数名称，长度必须介于 1-100 字节。
2.  输出参数通过[HUKS\_EXT\_CRYPTO\_TAG\_EXTRA\_DATA](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-huksexternalcrypto#huksexternalcryptotag)携带，应用可以提取该查询出的属性数据，并按照和驱动应用（外部密钥管理扩展能力提供方）的约定，解析数据。

#### 支持的属性函数名称（示例）

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

| 函数名 | 说明 |
| :-- | :-- |
| SKF\_GetDevInfo | 获取设备信息。 |
| SKF\_EnumDev | 枚举设备。 |
| SKF\_EnumContainer | 枚举容器。 |
| SKF\_EnumApplication | 枚举应用。 |

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a5/v3/1fu6Krg0SBq1_pKkMsgSDQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132429Z&HW-CC-Expire=86400&HW-CC-Sign=5DD10858166FDDF165FA1017A8A1009BDCBCA0E88780A2AAFA35FF341815D868)

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