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