• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 查询密钥别名集(C/C++)
2
3<!--Kit: Universal Keystore Kit-->
4<!--Subsystem: Security-->
5<!--Owner: @wutiantian-gitee-->
6<!--Designer: @HighLowWorld-->
7<!--Tester: @wxy1234564846-->
8<!--Adviser: @zengyawen-->
9
10HUKS提供了接口供应用查询密钥别名集。
11
12>**说明：**
13> <!--RP1-->轻量级设备<!--RP1End-->不支持查询密钥别名集功能。
14
15## 在CMake脚本中链接相关动态库
16```txt
17target_link_libraries(entry PUBLIC libhuks_ndk.z.so)
18```
19
20## 开发步骤
21
221. 初始化密钥属性集。用于查询指定密钥别名集TAG，TAG仅支持[OH_HUKS_TAG_AUTH_STORAGE_LEVEL](../../reference/apis-universal-keystore-kit/capi-native-huks-type-h.md#oh_huks_authstoragelevel)。
23
242. 调用接口[OH_Huks_ListAliases](../../reference/apis-universal-keystore-kit/capi-native-huks-api-h.md#oh_huks_listaliases)，查询密钥别名集。
25
26 ```c++
27/* 以下查询密钥别名集为例 */
28#include "huks/native_huks_api.h"
29#include "huks/native_huks_param.h"
30#include "napi/native_api.h"
31#include <string.h>
32
33OH_Huks_Result InitParamSet(
34    struct OH_Huks_ParamSet **paramSet,
35    const struct OH_Huks_Param *params,
36    uint32_t paramCount)
37{
38    OH_Huks_Result ret = OH_Huks_InitParamSet(paramSet);
39    if (ret.errorCode != OH_HUKS_SUCCESS) {
40        return ret;
41    }
42    ret = OH_Huks_AddParams(*paramSet, params, paramCount);
43    if (ret.errorCode != OH_HUKS_SUCCESS) {
44        OH_Huks_FreeParamSet(paramSet);
45        return ret;
46    }
47    ret = OH_Huks_BuildParamSet(paramSet);
48    if (ret.errorCode != OH_HUKS_SUCCESS) {
49        OH_Huks_FreeParamSet(paramSet);
50        return ret;
51    }
52    return ret;
53}
54
55struct OH_Huks_Param g_testQueryParam[] = {
56    {
57        .tag = OH_HUKS_TAG_AUTH_STORAGE_LEVEL,
58        .uint32Param = OH_HUKS_AUTH_STORAGE_LEVEL_DE
59    },
60};
61
62static napi_value ListAliases(napi_env env, napi_callback_info info)
63{
64    struct OH_Huks_ParamSet *testQueryParamSet = nullptr;
65    struct OH_Huks_KeyAliasSet *outData = nullptr;
66    struct OH_Huks_Result ohResult;
67    do {
68        /* 1.初始化密钥属性集 */
69        ohResult = InitParamSet(&testQueryParamSet, g_testQueryParam, sizeof(g_testQueryParam) / sizeof(OH_Huks_Param));
70        if (ohResult.errorCode != OH_HUKS_SUCCESS) {
71            break;
72        }
73        /* 2.查询密钥别名集 */
74        ohResult = OH_Huks_ListAliases(testQueryParamSet, &outData);
75    } while (0);
76
77    OH_Huks_FreeParamSet(&testQueryParamSet);
78    OH_Huks_FreeKeyAliasSet(outData);
79    napi_value ret;
80    napi_create_int32(env, ohResult.errorCode, &ret);
81    return ret;
82}
83```