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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d1/v3/3wdtIzEETwOLJm2TZLCetg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073425Z&HW-CC-Expire=86400&HW-CC-Sign=1F7163FFC4569E99ADBA7D2B6383B6EEF2D382746881743C22B565219C3402DE)

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/19/v3/c3qOm8fOTTu3y4Oal83y7Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073425Z&HW-CC-Expire=86400&HW-CC-Sign=0678EA32B11338C6BFD992A2447922151A548DF75DD058F25FA4B8E1A155BEE2)

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