---
title: 以聚合模式打开文件
description: "MPI_File_open(MPI_Comm comm, const char* filename, int amode, MPI_Info info, MPI_File *fh)"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0017.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0017.html
indexId: e0c05e051e0da41ea5dc92df073cc2090502b631f48b03da3f9e528d084efa3758
---
# 以聚合模式打开文件

#### 函数定义

MPI_File_open(MPI_Comm comm, const char* filename, int amode, MPI_Info info, MPI_File *fh)

PMPI_File_open(MPI_Comm comm, const char* filename, int amode, MPI_Info info, MPI_File *fh)


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| comm | 通信器（句柄） | 非空 | 输入 |
| \*filename | 要打开文件的名称 | 非空，长度小于256字节 | 输入 |
| amode | 文件访问模式 | 整数 | 输入 |
| info | Info对象（句柄） | 非空 | 输入 |
| \*fh | 目标地址，存放新的文件（句柄） | 非空 | 输出 |


#### 返回值

- 成功：返回MPI_SUCCESS。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| MPI\_ERR\_BAD\_FILE | 无效的文件名 |
| MPI\_ERR\_AMODE | 不支持的访问模式 |
| MPI\_ERR\_ARG | 其他类型的无效参数 |
| MPI\_ERR\_ACCESS | 权限被拒绝 |
| MPI\_ERR\_IO | 其他I/O错误 |
| MPI\_ERR\_OTHER | 其他错误 |


#### 注意

Hyper IO支持以以下amode打开文件：

- MPI_MODE_CREATE
- MPI_MODE_DELETE_ON_CLOSE
- MPI_MODE_RDONLY
- MPI_MODE_WRONLY
- MPI_MODE_RDWR（将以只写看待，若以此模式打开文件后执行读操作，将报错）