---
title: 创建属性
description: "创建附加到指定对象的属性。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0088.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0088.html
indexId: 4751cffb3ed5d4be2a75f54d649922b823921f8172704da110c42f6e190b2f7958
---
# 创建属性

#### 函数定义

创建附加到指定对象的属性。

hid_t H5Acreate2(hid_t loc, const char *name, hid_t datatypeId, hid_t spaceId, hid_t createPlistId, hid_t accessPlistId )


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| loc | 位置标识符。标识符可以是文件、组、数据集或命名数据类型的标识符。 | 整数 | 输入 |
| \*name | 属性名称。 | 非空，长度小于256字节 | 输入 |
| datatypeId | 属性数据类型标识符。 | 整数 | 输入 |
| spaceId | 数据空间标识符。 | 整数 | 输入 |
| createPlistId | 属性创建属性列表标识符。 | 整数，参数acpl\_id目前未使用，指定H5P\_DEFAULT | 输入 |
| accessPlistId | 属性的访问列表标识符。 | 整数，参数aapl\_id目前未使用，指定H5P\_DEFAULT | 输入 |


#### 返回值

- 成功：返回属性标识符。
- 失败：返回负值。