---
title: 创建群组
description: "创建一个新的空组并为其指定名称。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0103.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0103.html
indexId: b559ac9b77e84695b263cdfdf683bcd0f595b3ade059fb3b196e42ee6bb105e858
---
# 创建群组

#### 函数定义

创建一个新的空组并为其指定名称。

hid_t H5Gcreate2( hid_t parentId, const char *name, hid_t linkCreatePlistId, hid_t createPlistId, hid_t accessPlistId)


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| parentId | 位置标识符；可以是文件、组、数据集、命名数据类型或属性。 | 整数 | 输入 |
| \*name | 指向新组的链接的绝对或相对名称。 | 非空，长度小于256字节 | 输入 |
| linkCreatePlistId | 链路创建属性列表标识符。 | 整数，参数lcpl\_id目前未使用，指定H5P\_DEFAULT | 输入 |
| createPlistId | 群组创建属性列表标识符。 | 整数，参数gcpl\_id目前未使用，指定H5P\_DEFAULT | 输入 |
| accessPlistId | 群组访问属性列表标识符。 | 整数，参数gapl\_id目前未使用，指定H5P\_DEFAULT | 输入 |


#### 返回值

- 成功：返回群组标识符。
- 失败：返回负值。