Sdílet prostřednictvím


MPI_Comm_free_keyval funkce

Uvolní existující klíč atributu.

Syntaxe

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

Parametry

  • comm_keyval
    Hodnota klíče:

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

Poznámky

Tato funkce nastaví hodnotu keyval na MPI_KEYVAL_INVALID. Všimněte si, že není chybné uvolnit klíč atributu, který se používá, protože skutečný volný se ukáže, dokud nebudou uvolněny všechny odkazy (v jiných komunikátorech v procesu) na klíč. Tyto odkazy musí být programem uvolněny, a to buď voláním MPI_Comm_delete_attr , která uvolní instanci jednoho atributu, nebo voláním MPI_Comm_free , které uvolní všechny instance atributů přidružené k uvolněné communicator.

Požadavky

Produkt

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

Hlavička

Mpi.h; Mpif.h

Knihovna

Msmpi.lib

DLL

Msmpi.dll

Viz také

Funkce ukládání do mezipaměti MPI