1# 获取密钥属性(C/C++) 2 3 4HUKS提供了接口供业务获取指定密钥的相关属性。在获取指定密钥属性前，需要确保已在HUKS中生成或导入持久化存储的密钥。 5 6## 在CMake脚本中链接相关动态库 7```txt 8 target_link_libraries(entry PUBLIC libhuks_ndk.z.so) 9``` 10 11## 开发步骤 12 131. 构造对应参数。 14 - keyAlias：密钥别名，封装成[OH_Huks_Blob](../../reference/apis-universal-keystore-kit/_o_h___huks___blob.md)结构，密钥别名最大长度为128字节。 15 - paramSetIn：预留参数，暂不需要处理，传空即可。 16 - paramSetOut：用于放置获取到的参数集结果，为[OH_Huks_ParamSet](../../reference/apis-universal-keystore-kit/_o_h___huks___param_set.md)类型对象，需要业务提前申请好内存，需申请足够容纳获取到的密钥属性集的内存大小。 17 182. 调用接口[OH_Huks_GetKeyItemParamSet](../../reference/apis-universal-keystore-kit/_huks_key_api.md#oh_huks_getkeyitemparamset)，传入上述参数。 19 203. 返回值为成功码/错误码，获取成功后，从参数集中读取需要的参数。 21 22```c++ 23#include "huks/native_huks_api.h" 24#include "huks/native_huks_param.h" 25#include <string.h> 26static napi_value GetKeyParamSet(napi_env env, napi_callback_info info) 27{ 28 /* 1. 参数构造：确定密钥别名 */ 29 const char *alias = "test_key"; 30 struct OH_Huks_Blob aliasBlob = { .size = (uint32_t)strlen(alias), .data = (uint8_t *)alias }; 31 /* 构造参数：为参数集申请内存 */ 32 struct OH_Huks_ParamSet *outParamSet = (struct OH_Huks_ParamSet *)malloc(512); // 请业务按实际情况评估大小进行申请 33 if (outParamSet == nullptr) { 34 return nullptr; 35 } 36 outParamSet->paramSetSize = 512; 37 struct OH_Huks_Result ohResult; 38 do { 39 /* 2. 获取密钥属性集 */ 40 ohResult = OH_Huks_GetKeyItemParamSet(&aliasBlob, nullptr, outParamSet); 41 if (ohResult.errorCode != OH_HUKS_SUCCESS) { 42 break; 43 } 44 /* 3. 从参数集中读取参数，以OH_HUKS_TAG_PURPOSE为例 */ 45 OH_Huks_Param *purposeParam = nullptr; // 无需申请内存，获取后指针指向该参数在参数集中所处内存地址 46 ohResult = OH_Huks_GetParam(outParamSet, OH_HUKS_TAG_PURPOSE, &purposeParam); 47 if (ohResult.errorCode != OH_HUKS_SUCCESS) { 48 break; 49 } 50 } while (0); 51 OH_Huks_FreeParamSet(&outParamSet); 52 napi_value ret; 53 napi_create_int32(env, ohResult.errorCode, &ret); 54 return ret; 55} 56``` 57