17.2.356. MPI_T_cvar_write
MPI_T_cvar_write — 写入绑定控制变量的值
17.2.356.1. 语法
17.2.356.1.1. C语言语法
#include <mpi.h>
int MPI_T_cvar_write(MPI_T_cvar_handle handle, const void *buf)
17.2.356.2. 输入参数
handle: 待写入的控制变量的句柄。buf: 变量值存储位置的初始地址。
17.2.356.3. 描述
MPI_T_cvar_write 通过handle参数指定的句柄，将buf缓冲区中提供的值设置到对应的控制变量中。调用者必须确保buf指定的缓冲区足够大以容纳控制变量的整个值。如果该变量具有全局作用域，则必须在所有连接的MPI进程上发出写入调用。更多信息请参阅MPI-3标准第14.3.6节。
17.2.356.4. 错误
MPI_T_cvar_write 在以下情况下会失败：
MPI_T_ERR_NOT_INITIALIZED: MPI工具接口未初始化MPI_T_ERR_INVALID_HANDLE: 句柄无效MPI_T_ERR_CVAR_SET_NOT_NOW: 变量当前无法设置MPI_T_ERR_CVAR_SET_NEVER: 该变量在执行结束前无法设置