kkeyset_create 内核服务

在线编辑

用途

创建并初始化内核密钥集。

语法

#include <sys/kerrno.h>
#include <sys/skeys.h>
kerrno_t kkeyset_create (set)
kkeyset_t *set;

参数

项 描述
set 包含返回的新创建的密钥集。

描述

kkeyset_create 内核服务会创建新的 (空的) 内核密钥集。 您可以使用 kkeyset_add_key， kkeyset_remove_key， kkeyset_add_set和 kkeyset_remove_set 内核服务来添加或除去对单个或多个内核密钥组的访问权。

重要信息: kkeyset_create 内核服务分配隐藏的内核资源。 当内核密钥集不再使用时，必须使用 kkeyset_delete 内核服务来释放这些资源。 创建新集时， kkeyset_create 内核服务的调用者必须将包含返回的内核密钥集 (*set) 的存储器初始化为 KKEYSET_INVALID 值。

执行环境

只能从 进程 环境调用 kkeyset_create 内核服务。

返回值

项 描述
重大安全事件数量 指示成功完成。
enomem_kkeyset_create 指示可用内存不足，无法满足请求。
einval_kkeyset_create 指示该参数或执行环境无效。