MPI_Comm_free_keyval 函数

释放现有的属性键。

语法

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

参数

  • comm_keyval
    键值。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

注解

此函数将 keyval 的值设置为 MPI_KEYVAL_INVALID。 请注意,释放正在使用的属性键并不错误,因为直到释放对密钥) 进程的其他通信器中的所有引用 (之后,实际的 free 才会发生。 这些引用需要由程序明确释放,无论是通过调用释放一个属性实例 的MPI_Comm_delete_attr ,还是调用释放与释放的通信器关联的所有属性实例 的MPI_Comm_free

要求

产品

HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具

标头

Mpi.h;Mpif.h

Msmpi.lib

DLL

Msmpi.dll

另请参阅

MPI 缓存函数