Partilhar via


função MPI_Comm_free_keyval

Liberta uma chave de atributo existente.

Sintaxe

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

Parâmetros

  • comm_keyval
    Valor de chave.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

Observações

Esta função define o valor de keyval para MPI_KEYVAL_INVALID. Tenha em atenção que não é errado libertar uma chave de atributo que está a ser utilizada, uma vez que o livre real não se verifica até que todas as referências (noutros comunicadores no processo) à chave tenham sido libertadas. Estas referências têm de ser explicavelmente libertadas pelo programa, quer através de chamadas para MPI_Comm_delete_attr que libertem uma instância de atributo, quer através de chamadas para MPI_Comm_free que libertem todas as instâncias de atributo associadas ao comunicador libertado.

Requisitos

Produto

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

Funções de Colocação em Cache de MPI