---
title: 创建新数据集
description: "在指定位置创建数据集。"
url: https://www.hikunpeng.com/document/detail/zh/hpchistory/hpckit/develop2400/userg_hyperio_0095.html
sourcePath: /source/zh/hpchistory/hpckit/develop2400/userg_hyperio_0095.html
indexId: f35360e02ce55890dc1c41f34c96f82231fe706f5c14b9dcef36ef74c226dfb264
---
# 创建新数据集

#### 函数定义

在指定位置创建数据集。

hid_t H5Dcreate2( hid_t parentId, const char *name, hid_t datatypeId, hid_t spaceId, hid_t linkCreatePlistId, hid_t createPlistId, hid_t accessPlistId )


#### 参数

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


#### 返回值

- 成功：返回数据集标识符。
- 失败：返回负值。