---
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/hpchistory/hpckit/develop2400/userg_hyperio_0017.html
sourcePath: /source/zh/hpchistory/hpckit/develop2400/userg_hyperio_0017.html
indexId: 1fcff0a7090bf91f9b7dcfca269b08824f8b0b06a57adaac93eb5e7bc8f93bb464
---
# 以聚合模式打开文件

#### 函数定义

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（将以只写看待，若以此模式打开文件后执行读操作，将报错）