Dela via


funktionen MPI_Comm_free_keyval

Frigör en befintlig attributnyckel.

Syntax

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

Parametrar

  • comm_keyval
    Nyckelvärde.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

Kommentarer

Den här funktionen anger värdet för keyval till MPI_KEYVAL_INVALID. Observera att det inte är felaktigt att frigöra en attributnyckel som används, eftersom den faktiska kostnadsfria filen inte visas förrän alla referenser (i andra kommunikatörer i processen) till nyckeln har frigjorts. Dessa referenser måste frigöras oförklarligt av programmet, antingen via anrop till MPI_Comm_delete_attr som frigör en attributinstans eller genom anrop till MPI_Comm_free som frigör alla attributinstanser som är associerade med den frigjorda kommunikatören.

Krav

Produkt

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

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

Cachelagringsfunktioner för MPI