• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 查询密钥别名集(C/C++)
2
3
4HUKS提供了接口供应用查询密钥别名集。
5
6## 在CMake脚本中链接相关动态库
7```txt
8   target_link_libraries(entry PUBLIC libhuks_ndk.z.so)
9```
10
11## 开发步骤
12
131. 初始化密钥属性集。用于查询指定密钥别名集TAG,TAG仅支持[HUKS_TAG_AUTH_STORAGE_LEVEL](../../reference/apis-universal-keystore-kit/_huks_type_api.md#oh_huks_authstoragelevel)。
14
152. 调用接口[OH_Huks_ListAliases](../../reference/apis-universal-keystore-kit/_huks_key_api.md#oh_huks_listaliases),查询密钥别名集。
16
17 ```c++
18/* 以下查询密钥别名集为例 */
19#include "huks/native_huks_api.h"
20#include "huks/native_huks_param.h"
21#include <string.h>
22OH_Huks_Result InitParamSet(
23    struct OH_Huks_ParamSet **paramSet,
24    const struct OH_Huks_Param *params,
25    uint32_t paramCount)
26{
27    OH_Huks_Result ret = OH_Huks_InitParamSet(paramSet);
28    if (ret.errorCode != OH_HUKS_SUCCESS) {
29        return ret;
30    }
31    ret = OH_Huks_AddParams(*paramSet, params, paramCount);
32    if (ret.errorCode != OH_HUKS_SUCCESS) {
33        OH_Huks_FreeParamSet(paramSet);
34        return ret;
35    }
36    ret = OH_Huks_BuildParamSet(paramSet);
37    if (ret.errorCode != OH_HUKS_SUCCESS) {
38        OH_Huks_FreeParamSet(paramSet);
39        return ret;
40    }
41    return ret;
42}
43struct OH_Huks_Param g_testQueryParam[] = {
44    {
45        .tag = OH_HUKS_TAG_AUTH_STORAGE_LEVEL,
46        .uint32Param = OH_HUKS_AUTH_STORAGE_LEVEL_DE
47    },
48};
49static napi_value ListAliases(napi_env env, napi_callback_info info)
50{
51    struct OH_Huks_ParamSet *testQueryParamSet = nullptr;
52    struct OH_Huks_KeyAliasSet *outData = nullptr;
53    struct OH_Huks_Result ohResult;
54    do {
55        /* 1.初始化密钥属性集 */
56        ohResult = InitParamSet(&testQueryParamSet, g_testQueryParam,
57            sizeof(g_testQueryParam) / sizeof(OH_Huks_Param));
58        if (ohResult.errorCode != OH_HUKS_SUCCESS) {
59            break;
60        }
61        /* 2.查询密钥别名集 */
62        ohResult = OH_Huks_ListAliases(testQueryParamSet, &outData);
63    } while (0);
64
65    OH_Huks_FreeParamSet(&testQueryParamSet);
66    OH_Huks_FreeKeyAliasSet(outData);
67    napi_value ret;
68    napi_create_int32(env, ohResult.errorCode, &ret);
69    return ret;
70}
71```