Partager via


MPI_Comm_free_keyval, fonction

Libère une clé d’attribut existante.

Syntaxe

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

Paramètres

  • comm_keyval
    Valeur de clé.

Valeur retournée

Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.

Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

Remarques

Cette fonction définit la valeur de keyval sur MPI_KEYVAL_INVALID. Notez qu’il n’est pas erroné de libérer une clé d’attribut en cours d’utilisation, car le libre réel ne se produit qu’après que toutes les références (dans d’autres communicateurs sur le processus) à la clé ont été libérées. Ces références doivent être libérées de manière explicite par le programme, soit via des appels à MPI_Comm_delete_attr qui libèrent un instance d’attribut, soit par des appels à MPI_Comm_free qui libèrent toutes les instances d’attribut associées au communicateur libéré.

Configuration requise

Produit

Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008

En-tête

Mpi.h ; Mpif.h

Bibliothèque

Msmpi.lib

DLL

Msmpi.dll

Voir aussi

Fonctions de mise en cache MPI